

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
<a name="API_ModifyMountTargetSecurityGroups"></a>

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

Quando você cria um destino de montagem, o Amazon EFS também cria uma nova interface de rede. Para obter mais informações, consulte [CreateMountTarget](API_CreateMountTarget.md). 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
<a name="API_ModifyMountTargetSecurityGroups_RequestSyntax"></a>

```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json

{
   "SecurityGroups": [ "string" ]
}
```

## Parâmetros da Solicitação de URI
<a name="API_ModifyMountTargetSecurityGroups_RequestParameters"></a>

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

 ** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **   <a name="efs-ModifyMountTargetSecurityGroups-request-uri-MountTargetId"></a>
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}$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_ModifyMountTargetSecurityGroups_RequestBody"></a>

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

 ** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **   <a name="efs-ModifyMountTargetSecurityGroups-request-SecurityGroups"></a>
Uma matriz de grupos de segurança de VPC. IDs   
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
<a name="API_ModifyMountTargetSecurityGroups_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de resposta
<a name="API_ModifyMountTargetSecurityGroups_ResponseElements"></a>

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

## Erros
<a name="API_ModifyMountTargetSecurityGroups_Errors"></a>

 ** 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.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 400

 ** IncorrectMountTargetState **   
Retornado se o destino da montagem não estiver no estado correto para a operação.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de Status HTTP: 409

 ** InternalServerError **   
Retornado se ocorreu um erro no lado do servidor.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 500

 ** MountTargetNotFound **   
Retornado se não houver um destino de montagem com o ID especificado encontrado na Conta da AWS do chamador.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 404

 ** SecurityGroupLimitExceeded **   
Exibido se o número de `SecurityGroups` especificado na solicitação for maior que o limite, que se baseia na cota da conta. Exclua alguns grupos de segurança ou solicite que a cota da conta seja aumentada. Para acessar mais informações, consulte [Cotas da Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) no *Guia do usuário da Amazon VPC* (consulte a tabela **Grupos de segurança**).     
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 400

 ** SecurityGroupNotFound **   
Retornado se um dos grupos de segurança especificados não existir na nuvem privada virtual (VPC) da sub-rede.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 400

## Exemplos
<a name="API_ModifyMountTargetSecurityGroups_Examples"></a>

### Substituir os grupos de segurança de um destino de montagem
<a name="API_ModifyMountTargetSecurityGroups_Example_1"></a>

 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
<a name="API_ModifyMountTargetSecurityGroups_Example_1_Request"></a>

```
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
<a name="API_ModifyMountTargetSecurityGroups_Example_1_Response"></a>

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

## Consulte também
<a name="API_ModifyMountTargetSecurityGroups_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) 