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á. # PutFileSystemPolicy Aplica uma `FileSystemPolicy` do Amazon EFS a um sistema de arquivos do Amazon EFS. Uma política de sistema de arquivos é uma política baseada em recursos do IAM e pode conter várias declarações de política. Um sistema de arquivos sempre tem exatamente uma política de sistema de arquivos, que pode ser a política padrão ou uma política explícita definida ou atualizada usando essa operação de API. As políticas do sistema de arquivos EFS têm um limite de 20.000 caracteres. Quando uma política explícita é definida, ela substitui a política padrão. Para obter mais informações sobre a política padrão do sistema de arquivos, consulte [Política padrão do sistema de arquivos EFS](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy). **nota** As políticas do sistema de arquivos EFS têm um limite de 20.000 caracteres. Essa operação exige permissões para a ação `elasticfilesystem:PutFileSystemPolicy`. ## Sintaxe da Solicitação ``` PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1 Content-type: application/json { "BypassPolicyLockoutSafetyCheck": boolean, "Policy": "string" } ``` ## Parâmetros da Solicitação de URI A solicitação usa os seguintes parâmetros de URI: ** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) ** O ID do sistema de arquivos do EFS para o qual você deseja criar ou atualizar a `FileSystemPolicy`. Restrições de Tamanho: Tamanho máximo de 128. Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` Obrigatório: Sim ## Corpo da Solicitação A solicitação aceita os dados a seguir no formato JSON. ** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) ** (Opcional) Um booliano que especifica se é necessário ou não ignorar a verificação de segurança de bloqueio `FileSystemPolicy`. A verificação de segurança de bloqueio determina se a política na solicitação bloqueará ou impedirá que a entidade principal do IAM que está fazendo a solicitação faça o solicitações `PutFileSystemPolicy` futuras neste sistema de arquivos. Defina `BypassPolicyLockoutSafetyCheck` como `True` somente quando quiser impedir que a entidade principal do IAM que está fazendo a solicitação faça solicitações `PutFileSystemPolicy` subsequentes nesse sistema de arquivos. O valor padrão é `False`. Tipo: booliano Obrigatório: não ** [Policy](#API_PutFileSystemPolicy_RequestSyntax) ** A `FileSystemPolicy` que você está criando. Aceita uma definição de política formatada em JSON. As políticas do sistema de arquivos EFS têm um limite de 20.000 caracteres. Para descobrir mais sobre os elementos que compõem uma política de sistema de arquivos, consulte [Políticas baseadas em recursos do Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies). Tipo: string Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 20.000. Padrão: `[\s\S]+` Obrigatório: sim ## Sintaxe da resposta ``` HTTP/1.1 200 Content-type: application/json { "FileSystemId": "string", "Policy": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) ** Especifica o sistema de arquivos EFS ao qual a `FileSystemPolicy` se aplica. Tipo: string Restrições de tamanho: tamanho máximo de 128. Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) ** A `FileSystemPolicy` em formato JSON para o sistema de arquivos EFS. Tipo: string Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 20.000. Padrão: `[\s\S]+` ## 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. ** 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 ** FileSystemNotFound ** Retornado se o `FileSystemId` valor especificado não existir no valor do Conta da AWS solicitante. ** 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 ** IncorrectFileSystemLifeCycleState ** Retornado se o estado do ciclo de vida do sistema de arquivos não estiver “disponível”. ** 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 ** InvalidPolicyException ** Retornado se a `FileSystemPolicy` estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente. Retornado no caso de um erro na verificação de segurança do bloqueio da política. ** 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 ### Crie um EFS FileSystemPolicy A solicitação a seguir cria uma `FileSystemPolicy` que permite que todos os AWS diretores montem o sistema de arquivos EFS especificado com permissões de leitura e gravação. #### Exemplo de solicitação ``` PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1 { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticfilesystem:ClientMount", "elasticfilesystem:ClientWrite" ], "Principal": { "AWS": ["*"] }, } ] } ``` #### Resposta da amostra ``` { "Version": "2012-10-17", "Id": "1", "Statement": [ { "Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444", "Effect": "Allow", "Action": [ "elasticfilesystem:ClientMount", "elasticfilesystem:ClientWrite" ], "Principal": { "AWS": ["*"] }, "Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567" } ] } ``` ## Consulte também 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/PutFileSystemPolicy) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)