ModifyMountTargetSecurityGroups - Amazon Elastic File System

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: