リソース管理のプライベート リンクを管理する

この記事では、既存のリソース管理のプライベート リンクを操作する方法について説明します。 ここでは、既存のリソースを取得および削除するための API 操作を示します。

リソース管理のプライベート リンクを作成する必要がある場合は、ポータルを使用して Azure リソースを管理するためのプライベート リンクを作成する、または API を使用して Azure リソースを管理するためのプライベート リンクを作成するに関連するページを参照してください。

リソース管理のプライベート リンク

特定のリソース管理のプライベート リンクを取得するには、次の要求を送信します。

Azure CLI

例

# Login first with az login if not using Cloud Shell
az resourcemanagement private-link show --resource-group PrivateLinkTestRG --name NewRMPL

PowerShell

例

# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzResourceManagementPrivateLink -ResourceGroupName PrivateLinkTestRG -Name NewRMPL

REST

REST 呼び出し

  GET https://management.azure.com/subscriptions/{subscriptionID}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/resourceManagementPrivateLinks/{rmplName}?api-version=2020-05-01 

この操作によって次のものが返されます。

{
  "properties": {
    "privateEndpointConnections": []
  },
  "id": {rmplResourceId},
  "name": {rmplName},
  "type": "Microsoft.Authorization/resourceManagementPrivateLinks",
  "location": {region}
}

サブスクリプション内のすべてのリソース管理のプライベート リンクを取得するには、次のものを使用します。

Azure CLI

# Login first with az login if not using Cloud Shell
az resourcemanagement private-link list

PowerShell

# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzResourceManagementPrivateLink

REST

REST 呼び出し

GET
https://management.azure.com/subscriptions/{subscriptionID}/providers/Microsoft.Authorization/resourceManagementPrivateLinks?api-version=2020-05-01

この操作によって次のものが返されます。

[
  {
    "properties": {
      "privateEndpointConnections": []
    },
    "id": {rmplResourceId},
    "name": {rmplName},
    "type": "Microsoft.Authorization/resourceManagementPrivateLinks",
    "location": {region}
  },
  {
    "properties": {
      "privateEndpointConnections": []
    },
    "id": {rmplResourceId},
    "name": {rmplName},
    "type": "Microsoft.Authorization/resourceManagementPrivateLinks",
    "location": {region}
  }
]

特定のリソース管理のプライベート リンクを削除するには、次のものを使用します。

Azure CLI

例

# Login first with az login if not using Cloud Shell
az resourcemanagement private-link delete --resource-group PrivateLinkTestRG --name NewRMPL

PowerShell

例

# Login first with Connect-AzAccount if not using Cloud Shell
Remove-AzResourceManagementPrivateLink -ResourceGroupName PrivateLinkTestRG -Name NewRMPL

REST

REST 呼び出し

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/resourceManagementPrivateLinks/{rmplName}?api-version=2020-05-01

この操作によって Status 200 OK が返されます。

プライベート リンクの関連付け

管理グループの特定のプライベート リンクの関連付けを取得するには、次のものを使用します。

Azure CLI

例

# Login first with az login if not using Cloud Shell
az private-link association show --management-group-id fc096d27-0434-4460-a3ea-110df0422a2d --name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4

PowerShell

例

# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzPrivateLinkAssociation -ManagementGroupId fc096d27-0434-4460-a3ea-110df0422a2d -Name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4 | fl

REST

REST 呼び出し

GET
https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupID}/providers/Microsoft.Authorization/privateLinkAssociations?api-version=2020-05-01 

この操作によって次のものが返されます。

{
  "value": [
    {
      "properties": {
        "privateLink": {rmplResourceID},
        "tenantId": {tenantId},
        "scope": "/providers/Microsoft.Management/managementGroups/{managementGroupId}"
      },
      "id": {plaResourceId},
      "type": "Microsoft.Authorization/privateLinkAssociations",
      "name": {plaName}
    }
  ]
}

プライベート リンクの関連付けを削除するには、次のものを使用します。

Azure CLI

例

# Login first with az login if not using Cloud Shell
az private-link association delete --management-group-id 24f15700-370c-45bc-86a7-aee1b0c4eb8a --name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4

PowerShell

例

# Login first with Connect-AzAccount if not using Cloud Shell
Remove-AzPrivateLinkAssociation -ManagementGroupId 24f15700-370c-45bc-86a7-aee1b0c4eb8a -Name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4

REST

REST 呼び出し

DELETE 
https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupID}/providers/Microsoft.Authorization/privateLinkAssociations/{plaID}?api-version=2020-05-01

この操作によって Status 200 OK が返されます。

次のステップ

• プライベート リンクの詳細については、Azure Private Link に関するページを参照してください。
• プライベート エンドポイントを管理するには、プライベート エンドポイントの管理に関するページを参照してください。
• リソース管理のプライベート リンクを作成するには、ポータルを使用して Azure リソースを管理するためのプライベート リンクを作成する、または REST API を使用して Azure リソースを管理するためのプライベート リンクを作成するに関連するページを参照してください。