Private Link Scopes - List By Resource Group

Service:: Monitor

Version d'API:: 2021-09-01

Obtient une liste d’Azure Monitor PrivateLinkScopes au sein d’un groupe de ressources.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	AzureMonitorPrivateLinkScopeListResult	Liste contenant 0 ou plusieurs définitions Azure Monitor PrivateLinkScope.
Other Status Codes	ErrorResponse	Une erreur s’est produite.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

PrivateLinkScopeListByResourceGroup

Exemple de requête

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

Exemple de réponse

Code d’état:: 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
}

Définitions

Nom	Description
AccessMode	Types de mode d’accès.
AccessModeSettings	Propriétés qui définissent les paramètres du mode liaison privée d’étendue.
AccessModeSettingsExclusion	Propriétés qui définissent l’élément d’exclusion des paramètres du mode liaison privée d’étendue. Ce paramètre s’applique à une connexion de point de terminaison privé spécifique et remplace les paramètres par défaut de cette connexion de point de terminaison privé.
AzureMonitorPrivateLinkScope	Définition d’Azure Monitor PrivateLinkScope.
AzureMonitorPrivateLinkScopeListResult	Décrit la liste des ressources Azure Monitor PrivateLinkScope.
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
PrivateEndpoint	Ressource de point de terminaison privé.
PrivateEndpointConnection	Ressource de connexion de point de terminaison privé.
PrivateEndpointConnectionProvisioningState	État d’approvisionnement actuel.
PrivateEndpointServiceConnectionStatus	État de la connexion de point de terminaison privé.
PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

AccessMode

Énumération

Types de mode d’accès.

Valeur	Description
Open
PrivateOnly

AccessModeSettings

Object

Propriétés qui définissent les paramètres du mode liaison privée d’étendue.

Nom	Type	Description
exclusions	AccessModeSettingsExclusion[]	Liste des exclusions qui remplacent les paramètres du mode d’accès par défaut pour des connexions de point de terminaison privé spécifiques.
ingestionAccessMode	AccessMode	Spécifie le mode d’accès par défaut de l’ingestion par le biais de points de terminaison privés associés dans l’étendue. S’il n’est pas spécifié, la valeur par défaut est « Open ». Vous pouvez remplacer ce paramètre par défaut pour une connexion de point de terminaison privé spécifique en ajoutant une exclusion dans le tableau « exclusions ».
queryAccessMode	AccessMode	Spécifie le mode d’accès par défaut des requêtes par le biais de points de terminaison privés associés dans l’étendue. S’il n’est pas spécifié, la valeur par défaut est « Open ». Vous pouvez remplacer ce paramètre par défaut pour une connexion de point de terminaison privé spécifique en ajoutant une exclusion dans le tableau « exclusions ».

AccessModeSettingsExclusion

Object

Propriétés qui définissent l’élément d’exclusion des paramètres du mode liaison privée d’étendue. Ce paramètre s’applique à une connexion de point de terminaison privé spécifique et remplace les paramètres par défaut de cette connexion de point de terminaison privé.

Nom	Type	Description
ingestionAccessMode	AccessMode	Spécifie le mode d’accès de l’ingestion via la connexion de point de terminaison privé spécifiée dans l’exclusion.
privateEndpointConnectionName	string	Nom de connexion de point de terminaison privé associé au point de terminaison privé sur lequel nous voulons appliquer les paramètres de mode d’accès spécifiques.
queryAccessMode	AccessMode	Spécifie le mode d’accès des requêtes via la connexion de point de terminaison privé spécifiée dans l’exclusion.

AzureMonitorPrivateLinkScope

Object

Définition d’Azure Monitor PrivateLinkScope.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.accessModeSettings	AccessModeSettings	Paramètres du mode d’accès
properties.privateEndpointConnections	PrivateEndpointConnection[]	Liste des connexions de point de terminaison privé.
properties.provisioningState	string	État actuel de ce PrivateLinkScope : qu’il soit ou non approvisionné dans le groupe de ressources qu’il est défini. Les utilisateurs ne peuvent pas modifier cette valeur, mais sont en mesure de le lire. Les valeurs incluent l’approvisionnement, la réussite, l’annulation et l’échec.
systemData	systemData	Données système
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

AzureMonitorPrivateLinkScopeListResult

Object

Décrit la liste des ressources Azure Monitor PrivateLinkScope.

Nom	Type	Description
nextLink	string	URI permettant d’obtenir l’ensemble suivant de définitions Azure Monitor PrivateLinkScope si un trop grand nombre de PrivateLinkScopes sont retournés dans le jeu de résultats.
value	AzureMonitorPrivateLinkScope[]	Liste des définitions Azure Monitor PrivateLinkScope.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

PrivateEndpoint

Object

Ressource de point de terminaison privé.

Nom	Type	Description
id	string	Identificateur ARM pour le point de terminaison privé

PrivateEndpointConnection

Object

Ressource de connexion de point de terminaison privé.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nom de la ressource
properties.privateEndpoint	PrivateEndpoint	Ressource du point de terminaison privé.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	État d’approvisionnement de la ressource de connexion de point de terminaison privé.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

PrivateEndpointConnectionProvisioningState

Énumération

État d’approvisionnement actuel.

Valeur	Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Énumération

État de la connexion de point de terminaison privé.

Valeur	Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.

Nom	Type	Description
actionsRequired	string	Message indiquant si les modifications apportées au fournisseur de services nécessitent des mises à jour sur le consommateur.
description	string	Raison de l’approbation/rejet de la connexion.
status	PrivateEndpointServiceConnectionStatus	Indique si la connexion a été approuvée/rejetée/supprimée par le propriétaire du service.

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

Partager via

Private Link Scopes - List By Resource Group

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

PrivateLinkScopeListByResourceGroup

Exemple de requête

Exemple de réponse

Définitions

AccessMode

AccessModeSettings

AccessModeSettingsExclusion

AzureMonitorPrivateLinkScope

AzureMonitorPrivateLinkScopeListResult

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

systemData