Controllare la disponibilità del nome dell'account di archiviazione

Articolo
11/18/2016

Data di pubblicazione: marzo 2016

Il Verifica disponibilità di nome Account di archiviazione operazione verifica se il nome di account di archiviazione specificato è disponibile o se è già stato utilizzato.

Richiesta

Il Verifica disponibilità di nome Account di archiviazione richiesta può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione e <storage-account-name> con il nome che si desidera utilizzare per l'account di archiviazione.

Metodo	URI della richiesta
GET	`https://management.core.windows.net/<subscription-id>/services/storageservices/operations/isavailable/<storage-account-name>`

È necessario assicurarsi che la richiesta effettuata al servizio di gestione sia sicura. Per ulteriori informazioni, vedere l'autenticazione delle richieste di Gestione servizio.

Parametri URI

Nessuno.

Intestazioni della richiesta

Nella tabella seguente descrive le intestazioni di richiesta.

Intestazione della richiesta	Descrizione
`x-ms-version`	Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su `2012-03-01` o versione successiva. Per ulteriori informazioni sulle intestazioni di controllo delle versioni, vedere il controllo delle versioni di Service Management.

Corpo della richiesta

Nessuno.

Risposta

La risposta include un codice di stato HTTP, un set di intestazioni di risposta e un corpo della risposta.

Codice di stato

Un'operazione completata correttamente restituisce il codice di stato 200 (OK). Per informazioni sui codici di stato, vedere stato di gestione del servizio e codici di errore.

Intestazioni di risposta

La risposta per questa operazione include le intestazioni seguenti. La risposta può inoltre includere intestazioni HTTP standard aggiuntive. Rispettare tutte le intestazioni standard di specifica del protocollo HTTP/1.1.

Intestazione della risposta	Descrizione
`x-ms-request-id`	Un valore che identifica in modo univoco una richiesta effettuata nel servizio di gestione.

Corpo della risposta

Il formato del corpo della risposta è come segue:

  
<?xml version="1.0" encoding="utf-8"?>  
<AvailabilityResponse xmlns=”https://schemas.microsoft.com/windowsazure”>  
  <Result>name-availability</Result>  
  <Reason>reason-for-denial</Reason>  
</AvailabilityResponse>

Nella tabella seguente vengono descritti gli elementi nel corpo della risposta.

Nome dell'elemento	Descrizione
Risultato	Specifica un valore booleano che indica se il nome è disponibile per l'utilizzo. Se `true`, il nome è disponibile. Se `false`, il nome è già stato utilizzato e non può essere utilizzato.
Motivo	Specifica il motivo che non è stato possibile utilizzare un nome di account di archiviazione. Il valore sarà `true` Se il nome può essere utilizzato. Il motivo elemento è solo restituito utilizzando la versione 2013-03-01 o successiva.

Condividi tramite