az resource link

Manage links between resources.

Linking is a feature of the Resource Manager. It enables declaring relationships between resources even if they do not reside in the same resource group. Linking has no impact on resource usage, billing, or role-based access. It allows for managing multiple resources across groups as a single unit.

Commands

az resource link create Create a new link between resources.
az resource link delete Delete a link between resources.
az resource link list List resource links.
az resource link show Gets a resource link with the specified ID.
az resource link update Update link between resources.

Create a new link between resources.

az resource link create --link
--target
[--notes]
[--subscription]

Examples

Create a link from {SourceID} to {ResourceID} with notes

az resource link create --link {SourceID} --target {ResourceID} --notes "SourceID depends on ResourceID"

Required Parameters

--link

Fully-qualified resource ID of the resource link.

--target

Fully-qualified resource ID of the resource link target.

Optional Parameters

--notes

Notes for the link.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Delete a link between resources.

az resource link delete --link
[--subscription]

Examples

Delete link {LinkID}

az resource link delete --link {LinkID}

Required Parameters

--link

Fully-qualified resource ID of the resource link.

Optional Parameters

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

List resource links.

az resource link list [--filter]
[--scope]
[--subscription]

Examples

List links, filtering with {filter-string}

az resource link list --filter {filter-string}

List all links for resource group {ResourceGroup} in subscription {SubID}

az resource link list --scope /subscriptions/{SubID}/resourceGroups/{ResourceGroup}

Optional Parameters

--filter

Filter string for limiting results.

--scope

Fully-qualified scope for retrieving links.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Gets a resource link with the specified ID.

az resource link show --link
[--subscription]

Required Parameters

--link

Fully-qualified resource ID of the resource link.

Optional Parameters

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Update link between resources.

az resource link update --link
[--notes]
[--subscription]
[--target]

Examples

Update the notes for {LinkID} notes "some notes to explain this link"

az resource link update --link {LinkID} --notes "some notes to explain this link"

Required Parameters

--link

Fully-qualified resource ID of the resource link.

Optional Parameters

--notes

Notes for the link.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--target

Fully-qualified resource ID of the resource link target.