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.
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
-
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})$Exigido: Sim
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- BypassPolicyLockoutSafetyCheck
-
(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çõesPutFileSystemPolicyfuturas neste sistema de arquivos. DefinaBypassPolicyLockoutSafetyCheckcomoTruesomente quando quiser impedir que a entidade principal do IAM que está fazendo a solicitação faça solicitaçõesPutFileSystemPolicysubsequentes nesse sistema de arquivos. O valor padrão éFalse.Tipo: booliano
Obrigatório: não
- Policy
-
A
FileSystemPolicyque 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.Tipo: String
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 20.000.
Padrão:
[\s\S]+Exigido: 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
-
Especifica o sistema de arquivos EFS ao qual a
FileSystemPolicyse 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
-
A
FileSystemPolicyem 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
FileSystemIdvalor 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
FileSystemPolicyestiver 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:
