Service Association Links - List

Serviço:: Virtual Networks

Versão da API:: 2025-05-01

Obtém uma lista de links de associação de serviço para uma sub-rede.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subnetName	path	True	string	O nome da sub-rede.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
virtualNetworkName	path	True	string	O nome da rede virtual.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	ServiceAssociationLinksListResult	A operação do Azure foi concluída com êxito.
Other Status Codes	Common.CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Resposta de exemplo

Código de status:: 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"
      }
    }
  ]
}

Definições

Nome	Description
Common.CloudError	Uma resposta de erro do serviço.
Common.CloudErrorBody	Uma resposta de erro do serviço.
Common.ServiceAssociationLink	Recurso ServiceAssociationLink.
ProvisioningState	O estado de provisionamento do recurso do grupo de segurança do aplicativo.
ServiceAssociationLinksListResult	Coleção paginada de itens ServiceAssociationLink

Common.CloudError

Objeto

Uma resposta de erro do serviço.

Nome	Tipo	Description
error	Common.CloudErrorBody	Corpo do erro da nuvem.

Common.CloudErrorBody

Objeto

Uma resposta de erro do serviço.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details	Common.CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.

Common.ServiceAssociationLink

Objeto

Recurso ServiceAssociationLink.

Nome	Tipo	Description
etag	string	Uma cadeia de caracteres somente leitura exclusiva que é alterada sempre que o recurso é atualizado.
id	string	ID do recurso.
name	string	Nome do recurso exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso.
properties.allowDelete	boolean	Se for true, o recurso poderá ser excluído.
properties.link	string	Link para o recurso externo.
properties.linkedResourceType	string	Tipo de recurso do recurso vinculado.
properties.locations	string[]	Uma lista de locais.
properties.provisioningState	ProvisioningState	O estado de provisionamento do recurso de link de associação de serviço.
type	string	Tipo de recurso.

ProvisioningState

Enumeração

O estado de provisionamento do recurso do grupo de segurança do aplicativo.

Valor	Description
Failed	Falha
Succeeded	Succeeded
Canceled	Cancelado
Creating	Criando
Updating	Atualização
Deleting	Excluir

ServiceAssociationLinksListResult

Objeto

Coleção paginada de itens ServiceAssociationLink

Nome	Tipo	Description
nextLink	string (uri)	O link para a próxima página de itens
value	Common.ServiceAssociationLink[]	Os itens ServiceAssociationLink nesta página