Volumes - Peer External Cluster

Servizio:

Azure NetApp Files

Versione API:

2024-09-01

Avviare il peering del cluster
Avvia il peering del cluster esterno per questo volume di migrazione

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/peerExternalCluster?api-version=2024-09-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account NetApp Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$
poolName	path	True	string	Nome del pool di capacità Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string uuid	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
volumeName	path	True	string	Nome del volume Criterio di espressione regolare: ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
peerIpAddresses	True	string[]	Elenco di indirizzi IP di IC-LIF che possono essere usati per connettersi al cluster locale

Risposte

Nome	Tipo	Descrizione
200 OK	clusterPeerCommandResponse	OK
202 Accepted		Accettato Intestazioni Location: string
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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

Volumes_PeerExternalCluster

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/peerExternalCluster?api-version=2024-09-01

{
  "peerIpAddresses": [
    "0.0.0.1",
    "0.0.0.2",
    "0.0.0.3",
    "0.0.0.4",
    "0.0.0.5",
    "0.0.0.6"
  ]
}

Risposta di esempio

Codice di stato:

200

{
  "peerAcceptCommand": "cluster peer create -ipspace replication -encryption-protocol-proposed tls-psk -passphrase passphraseString -peer-addrs 1.1.1.1,1.1.1.2,1.1.1.3,1.1.1.4,1.1.1.5,1.1.1.6"
}

Codice di stato:

202

Location: https://management.azure.com/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/providers/Microsoft.NetApp/locations/eastus/operationResults/616ee961-4042-4935-b4a0-ed6f4dae0172?api-version=2024-09-01&operationResultResponseType=Location
Azure-AsyncOperation: https://management.azure.com/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/providers/Microsoft.NetApp/locations/eastus/operationResults/616ee961-4042-4935-b4a0-ed6f4dae0172?api-version=2024-09-01

Definizioni

Nome	Descrizione
clusterPeerCommandResponse	Informazioni sul processo di peering del cluster
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
peerClusterForVolumeMigrationRequest	Proprietà del cluster di origine per una richiesta peer del cluster

clusterPeerCommandResponse

Informazioni sul processo di peering del cluster

Nome	Tipo	Descrizione
peerAcceptCommand	string	Comando che deve essere eseguito su ONTAP esterno per accettare il peering del cluster. Sarà presente solo se clusterPeeringStatus è pending

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

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

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

peerClusterForVolumeMigrationRequest

Proprietà del cluster di origine per una richiesta peer del cluster

Nome	Tipo	Descrizione
peerIpAddresses	string[]	Elenco di indirizzi IP di IC-LIF che possono essere usati per connettersi al cluster locale