ModifyMountTargetSecurityGroups - Amazon Elastic File System

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

ModifyMountTargetSecurityGroups

Modifica o conjunto de security groups que estão em vigor para um destino de montagem.

Quando você cria um alvo de montagem, a Amazon EFS também cria uma nova interface de rede. Para ter mais informações, consulte CreateMountTarget. Essa operação substitui os grupos de segurança em vigor para a interface de rede associada a um destino de montagem, com os SecurityGroups fornecidos na solicitação. Essa operação exige que a interface de rede do destino de montagem tenha sido criada e que o estado do ciclo de vida do destino de montagem não seja deleted.

Essa operação exige permissões para as seguintes ações:

  • ação elasticfilesystem:ModifyMountTargetSecurityGroups no sistema de arquivos do destino de montagem.

  • Ação ec2:ModifyNetworkInterfaceAttribute na interface de rede do destino de montagem.

Sintaxe da Solicitação

PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1 Content-type: application/json { "SecurityGroups": [ "string" ] }

URIParâmetros de solicitação

A solicitação usa os seguintes URI parâmetros.

MountTargetId

O ID do destino de montagem cujos grupos de segurança você deseja modificar.

Restrições de tamanho: tamanho mínimo de 13. Tamanho máximo de 45.

Padrão: ^fsmt-[0-9a-f]{8,40}$

Exigido: Sim

Corpo da Solicitação

A solicitação aceita os seguintes dados no JSON formato.

SecurityGroups

Uma matriz de até cinco grupos VPC de segurançaIDs.

Tipo: Matriz de strings

Membros da matriz: número máximo de 100 itens.

Restrições de tamanho: tamanho mínimo de 11. Tamanho máximo de 43.

Padrão: ^sg-[0-9a-f]{8,40}

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 204

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com o HTTP corpo vazio.

Erros

BadRequest

Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente.

HTTPCódigo de status: 400

IncorrectMountTargetState

Retornado se o destino da montagem não estiver no estado correto para a operação.

HTTPCódigo de status: 409

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

HTTPCódigo de status: 500

MountTargetNotFound

Retornado se não houver um destino de montagem com o ID especificado encontrado na Conta da AWS do chamador.

HTTPCódigo de status: 404

SecurityGroupLimitExceeded

Retornado se o tamanho de SecurityGroups especificado na solicitação for maior que cinco.

HTTPCódigo de status: 400

SecurityGroupNotFound

Retornado se um dos grupos de segurança especificados não existir na nuvem privada virtual da sub-rede (VPC).

HTTPCódigo de status: 400

Exemplos

Substituir os grupos de segurança de um destino de montagem

O exemplo a seguir substitui os grupos de segurança em vigor na interface de rede associada a um destino de montagem.

Exemplo de solicitação

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" ] }

Resposta da amostra

HTTP/1.1 204 No Content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: