Disk Accesses - Update A Private Endpoint Connection

Servizio:

Compute

Versione API:

2025-01-02

Approvare o rifiutare una connessione endpoint privato nella risorsa di accesso al disco, questa opzione non può essere usata per creare una nuova connessione endpoint privata.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskAccesses/{diskAccessName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2025-01-02

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
diskAccessName	path	True	string	Nome della risorsa di accesso al disco che viene creata. Il nome non può essere modificato dopo la creazione del set di crittografia del disco. I caratteri supportati per il nome sono a-z, A-Z, 0-9, _ e -. La lunghezza massima del nome è di 80 caratteri.
privateEndpointConnectionName	path	True	string	Nome della connessione all'endpoint privato.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle 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.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.privateLinkServiceConnectionState	True	PrivateLinkServiceConnectionState	Raccolta di informazioni sullo stato della connessione tra DiskAccess e Rete virtuale.

Risposte

Nome	Tipo	Descrizione
200 OK	PrivateEndpointConnection	L'operazione di aggiornamento della risorsa 'PrivateEndpointConnection' è riuscita
202 Accepted	PrivateEndpointConnection	La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata. Intestazioni Location: string Retry-After: integer
Other Status Codes	CloudError	Risposta di errore imprevista.

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

approve a Private Endpoint Connection under a disk access resource.

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/myDiskAccess/privateEndpointConnections/myPrivateEndpointConnection?api-version=2025-01-02

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approving myPrivateEndpointConnection"
    }
  }
}

Risposta di esempio

Codice di stato:

200

{
  "name": "myPrivateEndpointConnectionName",
  "type": "Microsoft.Compute/diskAccesses/PrivateEndpointConnections",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/myDiskAccess/privateEndpoinConnections/myPrivateEndpointConnectionName",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
    },
    "privateLinkServiceConnectionState": {
      "actionsRequired": "None",
      "description": "Approving myPrivateEndpointConnection",
      "status": "Approved"
    }
  }
}

Codice di stato:

202

{
  "name": "myPrivateEndpointConenction",
  "type": "Microsoft.Compute/diskAccesses/privateEndpointConnections",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/myDiskAccess/privateEndpoinConnections/myPrivateEndpointConnectionName",
  "properties": {
    "provisioningState": "Updating",
    "privateEndpoint": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
    },
    "privateLinkServiceConnectionState": {
      "actionsRequired": "None",
      "description": "Approving myPrivateEndpointConnection",
      "status": "Approved"
    }
  }
}

Definizioni

Nome	Descrizione
ApiError	Errore API.
ApiErrorBase	Base di errore API.
CloudError	Risposta di errore dal servizio di calcolo.
createdByType	Tipo di identità che ha creato la risorsa.
InnerError	Dettagli dell'errore interno.
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.

ApiError

Oggetto

Errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore Api
innererror	InnerError	L'errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Oggetto

Base di errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore API.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

InnerError

Oggetto

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump di eccezione.
exceptiontype	string	Tipo di eccezione.

PrivateEndpoint

Oggetto

Risorsa endpoint privato.

Nome	Tipo	Descrizione
id	string	Identificatore ARM per l'endpoint privato

PrivateEndpointConnection

Oggetto

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 DiskAccess e Rete virtuale.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Stato di provisioning della risorsa di connessione dell'endpoint privato.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di 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

Oggetto

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

Oggetto

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.