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á.
GetRegionOptStatus
Recupera o status de ativação de uma região específica.
Sintaxe da Solicitação
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- AccountId
-
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa operação. Se você não especificar esse parâmetro, o padrão será a conta da Amazon Web Services da identidade usada para chamar a operação. Para usar esse parâmetro, o chamador deve ser uma identidade na conta de gerenciamento da organização ou em uma conta do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter todos os recursos habilitados e deve ter acesso confiável habilitado para o serviço de gerenciamento de contas e, opcionalmente, uma conta do administrador delegado atribuída.
nota
A conta de gerenciamento não pode especificar seu próprio
AccountId. Ela deve chamar a operação em um contexto autônomo sem incluir o parâmetroAccountId.Para chamar essa operação em uma conta que não é membro de uma organização, não especifique esse parâmetro. Em vez disso, chame a operação usando uma identidade pertencente à conta cujos contatos você deseja recuperar ou modificar.
Tipo: sequência
Padrão:
\d{12}Obrigatório: Não
- RegionName
-
Especifica o código de um determinado nome de região (por exemplo,
af-south-1). Essa função retornará o status de qualquer região que você passar para esse parâmetro.Tipo: String
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.
Exigido: Sim
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"RegionName": "string",
"RegionOptStatus": "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.
- RegionName
-
O código da região que foi passado.
Tipo: String
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.
- RegionOptStatus
-
Um dos possíveis status que uma região pode ter (Habilitada, Sendo habilitada, Desabilitada, Sendo desabilitada, Habilitada_por_Padrão).
Tipo: String
Valores Válidos:
ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Ocorreu uma falha na operação porque a identidade de chamada não tem as permissões mínimas necessárias.
- errorType
-
O valor preenchido no cabeçalho da
x-amzn-ErrorTyperesposta pelo API Gateway.
Código de status HTTP: 403
- InternalServerException
-
A operação falhou devido a um erro interno do AWS. Tente executar a operação novamente mais tarde.
- errorType
-
O valor preenchido no cabeçalho da
x-amzn-ErrorTyperesposta pelo API Gateway.
Código de status HTTP: 500
- TooManyRequestsException
-
Ocorreu uma falha na operação porque ela foi chamada com muita frequência e excedeu um limite de controle de utilização.
- errorType
-
O valor preenchido no cabeçalho da
x-amzn-ErrorTyperesposta pelo API Gateway.
Código de status HTTP: 429
- ValidationException
-
Ocorreu uma falha na operação porque um dos parâmetros de entrada era inválido.
- fieldList
-
O campo em que a entrada inválida foi detectada.
- message
-
A mensagem que informa sobre o que era inválido na solicitação.
- reason
-
O motivo da falha na validação.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em uma linguagem específica AWS SDKs, consulte o seguinte:
