Add Relationship Base Type

.chronus/changes/add-relationship-base-type-2026-7-10-17-13-0.md

@@ -0,0 +1,8 @@
+---
+changeKind: feature
+packages:
+  - "@azure-tools/typespec-azure-resource-manager"
+  - "@azure-tools/typespec-azure-rulesets"
+---
+
+Add the experimental Relationship base type for Azure Resource Manager extension resources, including flat relationship properties and lint validation for Relationship base type conformance.

packages/samples/specs/resource-manager/resource-types/relationship/main.tsp

@@ -0,0 +1,107 @@
+import "@typespec/rest";
+import "@typespec/versioning";
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+
+using Http;
+using Rest;
+using Versioning;
+using Azure.ResourceManager;
+using Azure.ResourceManager.BaseTypes.Relationships;
+
+/** Contoso Relationships Resource Provider management API. */
+@armProviderNamespace
+@service(#{ title: "ContosoRelationshipsClient" })
+@versioned(Versions)
+namespace Microsoft.ContosoRelationships;
+
+/** Contoso Relationships API versions */
+enum Versions {
+  /** 2024-06-01 version */
+  @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v5)
+  `2024-06-01`,
+}
+
+interface Operations extends Azure.ResourceManager.Operations {}
+
+/** Metadata for a Contoso dependency relationship. */
+model DependencyOfMetadata {
+  /** The type of the relationship source. */
+  sourceType: string;
+
+  /** The type of the relationship target. */
+  targetType: string;
+
+  /** A human-readable relationship description. */
+  description?: string;
+}
+
+/** Origin information for a Contoso dependency relationship. */
+model DependencyOfOriginInformation {
+  /** The origin type. */
+  relationshipOriginType: string;
+
+  /** The discovery engine that found the relationship. */
+  discoveryEngine?: string;
+}
+
+/** Provisioning state values for a Contoso dependency relationship async flow. */
+@Azure.Core.lroStatus
+union DependencyOfProvisioningState {
+  /** Include standard terminal provisioning states. */
+  ResourceProvisioningState,
+
+  /** The dependency relationship creation has been accepted. */
+  Accepted: "Accepted",
+
+  /** The dependency relationship is being provisioned. */
+  Provisioning: "Provisioning",
+
+  /** The dependency relationship is being deleted. */
+  Deleting: "Deleting",
+
+  string,
+}
+
+/** Properties for a Contoso dependency relationship. */
+model DependencyOfProperties
+  is RelationshipProperties<ProvisioningState = DependencyOfProvisioningState> {
+  /** Metadata describing the relationship source and target types. */
+  metadata: DependencyOfMetadata;
+
+  /** Information about the origin of the relationship. */
+  originInformation?: DependencyOfOriginInformation;
+}
+
+/**
+ * A dependency relationship between a source scope and target entity.
+ */
+#suppress "@azure-tools/typespec-azure-resource-manager/basetypes-experimental" "Experimental BaseTypes"
+model DependencyOf is Relationship<DependencyOfProperties> {
+  ...ResourceNameParameter<
+    Resource = DependencyOf,
+    KeyName = "relationshipName",
+    SegmentName = "dependencyOf",
+    NamePattern = "^[a-zA-Z0-9_.-]{1,64}$"
+  >;
+}
+
+/** Defines dependency relationship operations for a source scope. */
+interface DependencyOfOps<Scope extends Azure.ResourceManager.Foundations.SimpleResource> {
+  get is Extension.Read<Scope, DependencyOf>;
+  create is Extension.CreateOrReplaceAsync<Scope, DependencyOf>;
+  update is Extension.CustomPatchAsync<
+    Scope,
+    DependencyOf,
+    Azure.ResourceManager.Foundations.ResourceUpdateModel<DependencyOf, DependencyOfProperties>
+  >;
+  delete is Extension.DeleteWithoutOkAsync<Scope, DependencyOf>;
+  list is Extension.ListByTarget<Scope, DependencyOf>;
+}
+
+/**
+ * Operations over any source scope.
+ * Routes at: {scope}/providers/Microsoft.ContosoRelationships/dependencyOf/{relationshipName}
+ */
+@armResourceOperations
+interface DependencyOfRelationships extends DependencyOfOps<Extension.ScopeParameter> {}

packages/samples/specs/resource-manager/resource-types/relationship/sample-config.yaml

@@ -0,0 +1,7 @@
+title: Relationship Base Type
+description: Sample specification for a resource implementing the Relationship base type.
+
+llmstxt: false
+playground: false
+
+order: 9