Private Link Scopes - List By Resource Group

Servizio:: Monitor

Versione API:: 2021-09-01

Ottiene un elenco di PrivateLinkScopes di Monitoraggio di Azure all'interno di un gruppo di risorse.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/privateLinkScopes?api-version=2021-09-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	AzureMonitorPrivateLinkScopeListResult	Elenco contenente 0 o più definizioni privateLinkScope di Monitoraggio di Azure.
Other Status Codes	ErrorResponse	Si è verificato un errore.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

PrivateLinkScopeListByResourceGroup

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

{
  "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
}

Definizioni

Nome	Descrizione
AccessMode	Tipi di modalità di accesso.
AccessModeSettings	Proprietà che definiscono le impostazioni della modalità collegamento privato dell'ambito.
AccessModeSettingsExclusion	Proprietà che definiscono l'elemento di esclusione delle impostazioni della modalità collegamento privato dell'ambito. Questa impostazione si applica a una connessione endpoint privato specifica ed esegue l'override delle impostazioni predefinite per la connessione all'endpoint privato.
AzureMonitorPrivateLinkScope	Definizione PrivateLinkScope di Monitoraggio di Azure.
AzureMonitorPrivateLinkScopeListResult	Descrive l'elenco delle risorse PrivateLinkScope di Monitoraggio di Azure.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
PrivateEndpoint	Risorsa endpoint privato.
PrivateEndpointConnection	Risorsa connessione endpoint privato.
PrivateEndpointConnectionProvisioningState	Stato di provisioning corrente.
PrivateEndpointServiceConnectionStatus	Stato della connessione dell'endpoint privato.
PrivateLinkServiceConnectionState	Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AccessMode

Enumerazione

Tipi di modalità di accesso.

Valore	Descrizione
Open
PrivateOnly

AccessModeSettings

Object

Proprietà che definiscono le impostazioni della modalità collegamento privato dell'ambito.

Nome	Tipo	Descrizione
exclusions	AccessModeSettingsExclusion[]	Elenco di esclusioni che eseguono l'override delle impostazioni predefinite della modalità di accesso per connessioni endpoint private specifiche.
ingestionAccessMode	AccessMode	Specifica la modalità di accesso predefinita dell'inserimento tramite endpoint privati associati nell'ambito. Se il valore predefinito non specificato è 'Open'. È possibile eseguire l'override di questa impostazione predefinita per una connessione endpoint privata specifica aggiungendo un'esclusione nella matrice "esclusioni".
queryAccessMode	AccessMode	Specifica la modalità di accesso predefinita delle query tramite endpoint privati associati nell'ambito. Se il valore predefinito non specificato è 'Open'. È possibile eseguire l'override di questa impostazione predefinita per una connessione endpoint privata specifica aggiungendo un'esclusione nella matrice "esclusioni".

AccessModeSettingsExclusion

Object

Proprietà che definiscono l'elemento di esclusione delle impostazioni della modalità collegamento privato dell'ambito. Questa impostazione si applica a una connessione endpoint privato specifica ed esegue l'override delle impostazioni predefinite per la connessione all'endpoint privato.

Nome	Tipo	Descrizione
ingestionAccessMode	AccessMode	Specifica la modalità di accesso dell'inserimento tramite la connessione all'endpoint privato specificata nell'esclusione.
privateEndpointConnectionName	string	Nome della connessione dell'endpoint privato associato all'endpoint privato in cui si desidera applicare le impostazioni specifiche della modalità di accesso.
queryAccessMode	AccessMode	Specifica la modalità di accesso delle query tramite la connessione dell'endpoint privato specificata nell'esclusione.

AzureMonitorPrivateLinkScope

Object

Definizione PrivateLinkScope di Monitoraggio di Azure.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.accessModeSettings	AccessModeSettings	Impostazioni della modalità di accesso
properties.privateEndpointConnections	PrivateEndpointConnection[]	Elenco delle connessioni endpoint private.
properties.provisioningState	string	Stato corrente di questo PrivateLinkScope: indica se è stato effettuato il provisioning o meno all'interno del gruppo di risorse definito. Gli utenti non possono modificare questo valore, ma possono leggerlo. I valori includono Provisioning, Succeeded, Canceled e Failed.
systemData	systemData	Dati di sistema
tags	object	Tag di risorsa.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AzureMonitorPrivateLinkScopeListResult

Object

Descrive l'elenco delle risorse PrivateLinkScope di Monitoraggio di Azure.

Nome	Tipo	Descrizione
nextLink	string	URI per ottenere il set successivo di definizioni PrivateLinkScope di Monitoraggio di Azure se troppi PrivateLinkScopes vengono restituiti nel set di risultati.
value	AzureMonitorPrivateLinkScope[]	Elenco delle definizioni PrivateLinkScope di Monitoraggio di Azure.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

PrivateEndpoint

Object

Risorsa endpoint privato.

Nome	Tipo	Descrizione
id	string	Identificatore arm per endpoint privato

PrivateEndpointConnection

Object

Risorsa connessione endpoint privato.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties.privateEndpoint	PrivateEndpoint	Risorsa dell'endpoint privato.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Stato di provisioning della risorsa di connessione dell'endpoint privato.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Enumerazione

Stato di provisioning corrente.

Valore	Descrizione
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Enumerazione

Stato della connessione dell'endpoint privato.

Valore	Descrizione
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.

Nome	Tipo	Descrizione
actionsRequired	string	Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer.
description	string	Motivo dell'approvazione/rifiuto della connessione.
status	PrivateEndpointServiceConnectionStatus	Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio.

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Private Link Scopes - List By Resource Group

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

PrivateLinkScopeListByResourceGroup

Esempio di richiesta

Risposta di esempio

Definizioni

AccessMode

AccessModeSettings

AccessModeSettingsExclusion

AzureMonitorPrivateLinkScope

AzureMonitorPrivateLinkScopeListResult

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

systemData