Managed Environment Private Link Resources - List

Serviço:

Azure Container Apps

Versão da API:

2026-01-01

Listar recursos de link privado para um determinado ambiente gerenciado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/privateLinkResources?api-version=2026-01-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
environmentName	path	True	string pattern: ^[-\w\._\(\)]+$	Nome do Ambiente Gerenciado.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
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	PrivateLinkResourceListResult	OKEY
Other Status Codes	ErrorResponse	Resposta de erro.

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

List Private Link Resources by Managed Environment

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/managedEnv/privateLinkResources?api-version=2026-01-01

Resposta de exemplo

Código de status:

200

{
  "value": [
    {
      "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/managedEnv/privateLinkResources/managedEnvironments",
      "name": "managedEnvironments",
      "properties": {
        "groupId": "managedEnvironments",
        "requiredMembers": [
          "managedEnvironments"
        ],
        "requiredZoneNames": [
          "privatelink.northcentralusstage.azurecontainerapps.io"
        ]
      },
      "type": "Microsoft.App/managedEnvironments/privateLinkResources"
    }
  ]
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
PrivateLinkResource	Um recurso de link privado
PrivateLinkResourceListResult	Uma lista de recursos de link privado
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

PrivateLinkResource

Objeto

Um recurso de link privado

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.groupId	string	A ID do grupo de recursos de link privado.
properties.requiredMembers	string[]	Os nomes de membro necessários para o recurso de link privado.
properties.requiredZoneNames	string[]	O nome da zona DNS do link privado do recurso de link privado.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

PrivateLinkResourceListResult

Objeto

Uma lista de recursos de link privado

Nome	Tipo	Description
nextLink	string (uri)	URL para obter o próximo conjunto de resultados da lista de operações (se houver algum).
value	PrivateLinkResource[]	Matriz de recursos de link privado

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.