Service Association Links - List

サービス:: Virtual Networks

API バージョン:: 2025-05-01

サブネットのサービスアソシエーションリンクの一覧を取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}/serviceAssociationLinks?api-version=2025-05-01

URI パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subnetName	path	True	string	サブネットの名前。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
virtualNetworkName	path	True	string	仮想ネットワークの名前。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	ServiceAssociationLinksListResult	Azureの運用は無事に完了しました。
Other Status Codes	Common.CloudError	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Get Service Association Links

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet/subnets/subnet/serviceAssociationLinks?api-version=2025-05-01

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets a list of service association links for a subnet.
 *
 * @summary Gets a list of service association links for a subnet.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/VirtualNetworkGetServiceAssociationLinks.json
 */
async function getServiceAssociationLinks() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const virtualNetworkName = "vnet";
  const subnetName = "subnet";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.serviceAssociationLinks.list(
    resourceGroupName,
    virtualNetworkName,
    subnetName,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "value": [
    {
      "name": "acisal",
      "type": "Microsoft.Network/virtualNetworks/subnets/serviceAssociationLinks",
      "etag": "W/\"00000000-0000-0000-0000-000000000000\"",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet/subnets/subnet/serviceAssociationLinks/acisal",
      "properties": {
        "allowDelete": true,
        "linkedResourceType": "Microsoft.ContainerInstance/containerGroups",
        "locations": [
          "westus"
        ],
        "provisioningState": "Succeeded"
      }
    }
  ]
}

定義

名前	説明
Common.CloudError	サービスからのエラー応答。
Common.CloudErrorBody	サービスからのエラー応答。
Common.ServiceAssociationLink	ServiceAssociationLink リソース。
ProvisioningState	アプリケーションセキュリティグループリソースのプロビジョニング状態。
ServiceAssociationLinksListResult	ServiceAssociationLinkのページドコレクション

Common.CloudError

Object

サービスからのエラー応答。

名前	型	説明
error	Common.CloudErrorBody	クラウドエラー本文。

Common.CloudErrorBody

Object

サービスからのエラー応答。

名前	型	説明
code	string	エラーの識別子。コードは不変であり、プログラムで使用することを目的としています。
details	Common.CloudErrorBody[]	エラーに関する追加の詳細のリスト。
message	string	ユーザーインターフェイスでの表示に適したエラーを説明するメッセージ。
target	string	特定のエラーのターゲット。たとえば、エラーが発生したプロパティの名前です。

Common.ServiceAssociationLink

Object

ServiceAssociationLink リソース。

名前	型	説明
etag	string	リソースが更新されるたびに変更される一意の読み取り専用文字列。
id	string	リソース ID。
name	string	リソースグループ内で一意であるリソースの名前。この名前は、リソースへのアクセスに使用できます。
properties.allowDelete	boolean	true の場合、リソースを削除できます。
properties.link	string	外部リソースへのリンク。
properties.linkedResourceType	string	リンクされたリソースのリソースの種類。
properties.locations	string[]	場所の一覧。
properties.provisioningState	ProvisioningState	サービスアソシエーションリンクリソースのプロビジョニング状態。
type	string	リソースの種類。

ProvisioningState

列挙

アプリケーションセキュリティグループリソースのプロビジョニング状態。

値	説明
Failed	失敗
Succeeded	成功しました
Canceled	取り消し済み
Creating	作成
Updating	更新中
Deleting	削除中

ServiceAssociationLinksListResult

Object

ServiceAssociationLinkのページドコレクション

名前	型	説明
nextLink	string (uri)	項目の次のページへのリンク
value	Common.ServiceAssociationLink[]	このページのServiceAssociationLinkの項目