Compartilhar via


Private Link Scopes - List By Resource Group

Obtém uma lista de PrivateLinkScopes do Azure Monitor em um grupo de recursos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes?api-version=2021-09-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.

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

AzureMonitorPrivateLinkScopeListResult

Uma lista que contém 0 ou mais definições do PrivateLinkScope do Azure Monitor.

Other Status Codes

ErrorResponse

Ocorreu um 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

PrivateLinkScopeListByResourceGroup

Solicitação de exemplo

GET https://management.azure.com/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4919/resourceGroups/my-resource-group/providers/Microsoft.Insights/privateLinkScopes?api-version=2021-09-01

Resposta de exemplo

{
  "value": [
    {
      "id": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4919/resourceGroups/my-resource-group/providers/microsoft.insights/privateLinkScopes/my-privatelinkscope",
      "name": "my-privatelinkscope",
      "type": "Microsoft.Insights/privateLinkScopes",
      "location": "Global",
      "tags": {},
      "systemData": {
        "createdBy": "bobby@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-06-16T12:59:57.051056Z",
        "lastModifiedBy": "bobby@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-16T12:59:57.051056Z"
      },
      "properties": {
        "provisioningState": "Succeeded",
        "accessModeSettings": {
          "queryAccessMode": "Open",
          "ingestionAccessMode": "Open",
          "exclusions": []
        }
      }
    },
    {
      "id": "/subscriptions/86dc51d3-92ed-4d7e-947a-775ea79b4919/resourceGroups/my-resource-group/providers/microsoft.insights/privateLinkScopes/my-other-privatelinkscope",
      "name": "my-other-privatelinkscope",
      "type": "Microsoft.Insights/privateLinkScopes",
      "location": "Global",
      "tags": {},
      "systemData": {
        "createdBy": "bobby@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-06-16T12:59:57.051056Z",
        "lastModifiedBy": "bobby@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-16T12:59:57.051056Z"
      },
      "properties": {
        "provisioningState": "Succeeded",
        "accessModeSettings": {
          "queryAccessMode": "Open",
          "ingestionAccessMode": "Open",
          "exclusions": []
        }
      }
    }
  ],
  "nextLink": null
}

Definições

Nome Description
AccessMode

Tipos de modo de acesso.

AccessModeSettings

Propriedades que definem as configurações do modo de link privado de escopo.

AccessModeSettingsExclusion

Propriedades que definem o item de exclusão de configurações de modo de link privado de escopo. Essa configuração se aplica a uma conexão de ponto de extremidade privado específica e substitui as configurações padrão para essa conexão de ponto de extremidade privado.

AzureMonitorPrivateLinkScope

Uma definição de PrivateLinkScope do Azure Monitor.

AzureMonitorPrivateLinkScopeListResult

Descreve a lista de recursos do PrivateLinkScope do Azure Monitor.

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

PrivateEndpoint

O recurso de ponto de extremidade privado.

PrivateEndpointConnection

O recurso conexão de ponto de extremidade privado.

PrivateEndpointConnectionProvisioningState

O estado de provisionamento atual.

PrivateEndpointServiceConnectionStatus

O status da conexão do ponto de extremidade privado.

PrivateLinkServiceConnectionState

Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor.

systemData

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

AccessMode

Tipos de modo de acesso.

Valor Description
Open
PrivateOnly

AccessModeSettings

Propriedades que definem as configurações do modo de link privado de escopo.

Nome Tipo Description
exclusions

AccessModeSettingsExclusion[]

Lista de exclusões que substituem as configurações de modo de acesso padrão para conexões específicas de ponto de extremidade privado.

ingestionAccessMode

AccessMode

Especifica o modo de acesso padrão de ingestão por meio de pontos de extremidade privados associados no escopo. Se o valor padrão não especificado for 'Open'. Você pode substituir essa configuração padrão para uma conexão de ponto de extremidade privado específica adicionando uma exclusão na matriz "exclusões".

queryAccessMode

AccessMode

Especifica o modo de acesso padrão de consultas por meio de pontos de extremidade privados associados no escopo. Se o valor padrão não especificado for 'Open'. Você pode substituir essa configuração padrão para uma conexão de ponto de extremidade privado específica adicionando uma exclusão na matriz "exclusões".

AccessModeSettingsExclusion

Propriedades que definem o item de exclusão de configurações de modo de link privado de escopo. Essa configuração se aplica a uma conexão de ponto de extremidade privado específica e substitui as configurações padrão para essa conexão de ponto de extremidade privado.

Nome Tipo Description
ingestionAccessMode

AccessMode

Especifica o modo de acesso de ingestão por meio da conexão de ponto de extremidade privado especificada na exclusão.

privateEndpointConnectionName

string

O nome da conexão do ponto de extremidade privado associado ao ponto de extremidade privado no qual queremos aplicar as configurações específicas do modo de acesso.

queryAccessMode

AccessMode

Especifica o modo de acesso de consultas por meio da conexão de ponto de extremidade privado especificada na exclusão.

AzureMonitorPrivateLinkScope

Uma definição de PrivateLinkScope do Azure Monitor.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

A localização geográfica onde o recurso reside

name

string

O nome do recurso

properties.accessModeSettings

AccessModeSettings

Configurações do modo de acesso

properties.privateEndpointConnections

PrivateEndpointConnection[]

Lista de conexões de ponto de extremidade privado.

properties.provisioningState

string

Estado atual deste PrivateLinkScope: se ele foi provisionado ou não no grupo de recursos definido. Os usuários não podem alterar esse valor, mas podem lê-lo. Os valores incluirão Provisionamento, Êxito, Cancelado e Com Falha.

systemData

systemData

Dados do sistema

tags

object

Marcas de recurso.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AzureMonitorPrivateLinkScopeListResult

Descreve a lista de recursos do PrivateLinkScope do Azure Monitor.

Nome Tipo Description
nextLink

string

O URI para obter o próximo conjunto de definições do PrivateLinkScope do Azure Monitor se houver muitos PrivateLinkScopes retornados no conjunto de resultados.

value

AzureMonitorPrivateLinkScope[]

Lista de definições do PrivateLinkScope do Azure Monitor.

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

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

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

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

PrivateEndpoint

O recurso de ponto de extremidade privado.

Nome Tipo Description
id

string

O identificador do ARM para o ponto de extremidade privado

PrivateEndpointConnection

O recurso conexão de ponto de extremidade privado.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.privateEndpoint

PrivateEndpoint

O recurso do ponto de extremidade privado.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

O estado de provisionamento do recurso de conexão de ponto de extremidade privado.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

O estado de provisionamento atual.

Valor Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

O status da conexão do ponto de extremidade privado.

Valor Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor.

Nome Tipo Description
actionsRequired

string

Uma mensagem que indica se as alterações no provedor de serviços exigem atualizações no consumidor.

description

string

O motivo da aprovação/rejeição da conexão.

status

PrivateEndpointServiceConnectionStatus

Indica se a conexão foi aprovada/rejeitada/removida pelo proprietário do serviço.

systemData

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.