Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
ModifyMountTargetSecurityGroups
Modifica il set di gruppi di sicurezza attivi per un target di montaggio.
Quando crei un target di montaggio, Amazon EFS crea anche una nuova interfaccia di rete. Per ulteriori informazioni, consulta CreateMountTarget. Questa operazione sostituisce i gruppi di sicurezza in vigore per l'interfaccia di rete associata a un target di montaggio con i SecurityGroups
forniti nella richiesta. Questa operazione richiede che l'interfaccia di rete del target di montaggio sia stata creata e lo stato del ciclo di vita del target di montaggio non sia deleted
.
Questa operazione richiede autorizzazioni per le seguenti azioni:
-
Azione
elasticfilesystem:ModifyMountTargetSecurityGroups
sul file system del target di montaggio. -
Azione
ec2:ModifyNetworkInterfaceAttribute
sull'interfaccia di rete del target di montaggio.
Sintassi della richiesta
PUT /2015-02-01/mount-targets/MountTargetId
/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string
" ]
}
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- MountTargetId
-
L'ID del target di montaggio di cui si desidera modificare i gruppi di sicurezza.
Limitazioni di lunghezza: lunghezza minima pari a 13. La lunghezza massima è 45 caratteri.
Modello:
^fsmt-[0-9a-f]{8,40}$
Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- SecurityGroups
-
Una serie di gruppi di sicurezza VPC. IDs
Tipo: matrice di stringhe
Membri della matrice: numero massimo di 100 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 11. La lunghezza massima è 43 caratteri.
Modello:
^sg-[0-9a-f]{8,40}
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 204
Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
Errori
- BadRequest
-
Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.
- ErrorCode
-
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.
- Message
-
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400
- IncorrectMountTargetState
-
Restituito se il target di montaggio non è nello stato corretto per l'operazione.
- ErrorCode
-
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.
- Message
-
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 409
- InternalServerError
-
Restituito se si è verificato un errore lato server.
- ErrorCode
-
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.
- Message
-
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 500
- MountTargetNotFound
-
Restituito se non è presente alcun target di montaggio con l'ID specificato trovato nell' Account AWS del chiamante.
- ErrorCode
-
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.
- Message
-
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 404
- SecurityGroupLimitExceeded
-
Restituito se il numero
SecurityGroups
specificato nella richiesta è maggiore del limite, che si basa sulla quota dell'account. Elimina alcuni gruppi di sicurezza o richiedi l'aumento della quota dell'account. Per ulteriori informazioni, consulta Amazon VPC Quotas nella Amazon VPC User Guide (consulta la tabella dei gruppi di sicurezza).- ErrorCode
-
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.
- Message
-
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400
- SecurityGroupNotFound
-
Restituito se uno dei gruppi di sicurezza specificati non esiste nel cloud privato virtuale (VPC) della sottorete.
- ErrorCode
-
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.
- Message
-
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400
Esempi
Sostituzione dei gruppi di sicurezza di un target di montaggio
L'esempio seguente sostituisce i gruppi di sicurezza in vigore per l'interfaccia di rete associata a un target di montaggio.
Richiesta di esempio
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
Risposta di esempio
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: