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á.
Sintaxe e exemplos de políticas declarativas
Esta página fornece sintaxe exemplos das políticas declarativas.
Considerações
-
Quando você configura um atributo de serviço usando uma política declarativa, isso pode afetar vários APIs. Qualquer ação não compatível falhará.
-
Os administradores da conta não poderão modificar o valor do atributo de serviço no nível da conta individual.
Sintaxe para políticas declarativas
Uma política declarativa é um arquivo de texto sem formatação estruturado de acordo com as regras de JSON. A sintaxe para políticas declarativas segue a sintaxe para todos os tipos de política de gerenciamento. Para obter uma discussão completa sobre essa sintaxe, consulte Sintaxe de política e herança para tipos de política de gerenciamento. Este tópico se concentra na aplicação dessa sintaxe geral aos requisitos específicos do tipo de política declarativa.
O exemplo a seguir mostra a sintaxe da política declarativa:
{
"ec2_attributes": {
"exception_message": {
"@@assign": "Your custom error message.https://myURL"
},
...
[Insert supported service attributes]
...
}
}
-
O nome da chave de campo ec2_attributes. As políticas declarativas sempre começam com um nome de chave fixo para o determinado AWS service (Serviço da AWS). É a linha superior na política de exemplo acima. Atualmente, as políticas declarativas só oferecem suporte EC2 aos serviços relacionados à Amazon.
-
Emec2_attributes, você pode usar exception_message para definir uma mensagem de erro personalizada. Para obter mais informações, consulte Mensagens de erro personalizadas para políticas declarativas.
-
Emec2_attributes, você pode inserir uma ou mais das políticas declarativas suportadas. Para esses esquemas, consultePolíticas declarativas suportadas.
Políticas declarativas suportadas
A seguir estão os atributos Serviços da AWS e que as políticas declarativas suportam. Em alguns dos exemplos a seguir, a formatação de espaço em branco JSON pode ser compactada para economizar espaço.
-
Bloquear o Acesso Público da VPC
-
Acesso ao console serial
-
Bloquear o Acesso Público de Imagem
-
Configurações de imagem permitidas
-
Padrões de metadados da instância
-
Bloquear o Acesso Público do Snapshot
- VPC Block Public Access
-
Efeito político
Controla se os recursos na Amazon VPCs e nas sub-redes podem acessar a Internet por meio de gateways da Internet (). IGWs Para obter mais informações, consulte Configuração para acesso à Internet no Guia do usuário da Amazon Virtual Private Cloud.
Conteúdo da política
"vpc_block_public_access": {
"internet_gateway_block": { // (optional)
"mode": { // (required)
"@@assign": "block_ingress" // off | block_ingress | block_bidirectional
},
"exclusions_allowed": { // (required)
"@@assign": "enabled" // enabled | disabled
}
}
}
Estes são os campos disponíveis para esse atributo:
Considerações
Se você usar esse atributo em uma política declarativa, não poderá usar as operações a seguir para modificar a configuração imposta para as contas no escopo. Essa lista não é exaustiva:
-
ModifyVpcBlockPublicAccessOptions
-
CreateVpcBlockPublicAccessExclusion
-
ModifyVpcBlockPublicAccessExclusion
- Serial Console Access
-
Efeito político
Controla se o console EC2 serial está acessível. Para obter mais informações sobre o console EC2 serial, consulte o console EC2 serial no Guia do usuário do Amazon Elastic Compute Cloud.
Conteúdo da política
"serial_console_access": {
"status": { // (required)
"@@assign": "enabled" // enabled | disabled
}
}
Estes são os campos disponíveis para esse atributo:
Considerações
Se você usar esse atributo em uma política declarativa, não poderá usar as operações a seguir para modificar a configuração imposta para as contas no escopo. Essa lista não é exaustiva:
- Image Block Public Access
-
Efeito político
Controla se as Amazon Machine Images (AMIs) podem ser compartilhadas publicamente. Para obter mais informações sobre AMIs, consulte Amazon Machine Images (AMIs) no Guia do usuário do Amazon Elastic Compute Cloud.
Conteúdo da política
"image_block_public_access": {
"state": { // (required)
"@@assign": "block_new_sharing" // unblocked | block_new_sharing
}
}
Estes são os campos disponíveis para esse atributo:
-
"state":
-
"unblocked": Sem restrições ao compartilhamento público de AMIs.
-
"block_new_sharing": Bloqueia o novo compartilhamento público de AMIs. AMIs que já foram compartilhados publicamente permanecem disponíveis publicamente.
Considerações
Se você usar esse atributo em uma política declarativa, não poderá usar as operações a seguir para modificar a configuração imposta para as contas no escopo. Essa lista não é exaustiva:
- Allowed Images Settings
-
Efeito político
Controla a descoberta e o uso de Amazon Machine Images (AMI) na Amazon EC2 com Allowed AMIs.. Para obter mais informações sobre AMIs, consulte Amazon Machine Images (AMIs) no Guia do usuário do Amazon Elastic Compute Cloud.
Conteúdo da política
Estes são os campos disponíveis para esse atributo:
"allowed_images_settings": {
"state": { // (required)
"@@assign": "enabled" // enabled | disabled | audit_mode
},
"image_criteria": { // (optional)
"criteria_1": {
"allowed_image_providers": { // limit 200
"@@append": [
"amazon" // amazon | aws_marketplace | aws_backup_vault | 12 digit account ID
]
}
}
}
}
Considerações
Se você usar esse atributo em uma política declarativa, não poderá usar as operações a seguir para modificar a configuração imposta para as contas no escopo. Essa lista não é exaustiva:
-
EnableAllowedImagesSettings
-
ReplaceImageCriteriaInAllowedImagesSettings
-
DisableAllowedImagesSettings
- Instance Metadata Defaults
-
Efeito político
Controla os padrões do IMDS para todas as novas EC2 execuções de instâncias. Observe que essa configuração define somente padrões e não impõe as configurações de versão do IMDS. Para obter mais informações sobre os padrões do IMDS, consulte o IMDS no Guia do usuário do Amazon Elastic Compute Cloud.
Conteúdo da política
Estes são os campos disponíveis para esse atributo:
"instance_metadata_defaults": {
"http_tokens": { // (required)
"@@assign": "required" // no_preference | required | optional
},
"http_put_response_hop_limit": { // (required)
"@@assign": "4" // -1 | 1 -> 64
},
"http_endpoint": { // (required)
"@@assign": "enabled" // no_preference | enabled | disabled
},
"instance_metadata_tags": { // (required)
"@@assign": "enabled" // no_preference | enabled | disabled
}
}
- Snapshot Block Public Access
-
Efeito político
Controla se os snapshots do Amazon EBS são acessíveis publicamente. Para obter mais informações sobre os snapshots do EBS, consulte os snapshots do Amazon EBS no Guia do usuário do Amazon Elastic Block Store.
Conteúdo da política
"snapshot_block_public_access": {
"state": { // (required)
"@@assign": "block_new_sharing" // unblocked | block_new_sharing | block_all_sharing
}
}
Estes são os campos disponíveis para esse atributo:
-
"state":
-
"block_all_sharing": bloqueia todos os compartilhamentos de snapshots. Os snapshots que já foram compartilhados publicamente são tratados como privados e não estão mais disponíveis publicamente.
-
"block_new_sharing": bloqueia o novo compartilhamento público de instantâneos. Os snapshots que já foram compartilhados publicamente permanecem disponíveis publicamente.
-
"unblocked": sem restrições ao compartilhamento público dos snapshots.
Considerações
Se você usar esse atributo em uma política declarativa, não poderá usar as operações a seguir para modificar a configuração imposta para as contas no escopo. Essa lista não é exaustiva:
