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á.
CreateNamespace
(Somente edição Enterprise) Cria um novo namespace para você usar com a Amazon QuickSight.
Um namespace permite isolar a Amazon QuickSight usuários e grupos que estão registrados para esse namespace. Os usuários que acessam o namespace podem compartilhar ativos somente com outros usuários ou grupos no mesmo namespace. Eles não conseguem ver usuários e grupos em outros namespaces. Você pode criar um namespace após oAWSA conta tem permissão para a Amazon QuickSight. O namespace deve ser exclusivo naAWSconta. Por padrão, há um limite de 100 namespaces porAWSconta. Para aumentar seu limite, crie um ticket comAWS Support.
Sintaxe da solicitação
POST /accounts/AwsAccountId HTTP/1.1
Content-type: application/json
{
"IdentityStore": "string",
"Namespace": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AwsAccountId
-
O ID doAWSconta que você deseja criar a Amazon QuickSight namespace no.
Restrições de comprimento: Comprimento fixo de 12.
Padrão:
^[0-9]{12}$Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- IdentityStore
-
Especifica o tipo de seu diretório de identidade do usuário. Atualmente, isso oferece suporte a usuários com um tipo de identidade de
QUICKSIGHT.Type: String
Valores válidos:
QUICKSIGHTObrigatório: Sim
- Namespace
-
O nome que você deseja usar para descrever o novo namespace.
Type: String
Restrições de comprimento: Tamanho máximo de 64.
Padrão:
^[a-zA-Z0-9._-]*$Obrigatório: Sim
- Tags
-
As tags que você deseja associar ao namespace que você está criando.
Type: Matriz deTagobjetos
Membros da matriz: Número mínimo de 1 item. Número máximo de 200 itens.
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"CapacityRegion": "string",
"CreationStatus": "string",
"IdentityStore": "string",
"Name": "string",
"RequestId": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
- Status
-
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
- Arn
-
O ARN da Amazônia QuickSight namespace que você criou.
Type: String
- CapacityRegion
-
ORegião da AWS; que você deseja usar para a capacidade do SPICE para o novo namespace. Isso é definido para a região que você executa CreateNamespace no.
Type: String
- CreationStatus
-
O status de criação do namespace. Esse é um processo assíncrono. Um status de
CREATEDsignifica que o seu namespace está pronto para ser usado. Se ocorrer um erro, ele indicará se o processo estáretryableounon-retryable. No caso de um erro não passível de nova tentativa, consulte a mensagem de erro para tarefas de acompanhamento.Type: String
Valores válidos:
CREATED | CREATING | DELETING | RETRYABLE_FAILURE | NON_RETRYABLE_FAILURE - IdentityStore
-
Especifica o tipo de seu diretório de identidade do usuário. Atualmente, isso oferece suporte a usuários com um tipo de identidade de
QUICKSIGHT.Type: String
Valores válidos:
QUICKSIGHT - Name
-
O nome do novo namespace que você criou.
Type: String
Restrições de comprimento: Tamanho máximo de 64.
Padrão:
^[a-zA-Z0-9._-]*$ - RequestId
-
OAWSID da solicitação para essa operação.
Type: String
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulteErros comuns.
- AccessDeniedException
-
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight se as suas suas suas suas suas suas suas suas suas suas suas políticas têm as permissões de acesso as, se você está usando as permissões de acesso
Código de status HTTP: 401
- ConflictException
-
Atualizar ou excluir um recurso pode causar um estado inconsistente.
Código de status HTTP: 409
- InternalFailureException
-
Ocorreu um erro interno.
Código de status HTTP: 500
- InvalidParameterValueException
-
Um ou mais parâmetros têm um valor que não é válido.
Código de status HTTP: 400
- LimitExceededException
-
Um limite foi excedido.
Código de status HTTP: 409
- PreconditionNotMetException
-
Uma ou mais pré-condições não foram atendidas.
Código de status HTTP: 400
- ResourceExistsException
-
O recurso especificado já existe.
Código de status HTTP: 409
- ResourceNotFoundException
-
Não foi possível encontrar um ou mais recursos.
Código de status HTTP: 404
- ResourceUnavailableException
-
Este recurso está indisponível no momento.
Código de status HTTP: 503
- ThrottlingException
-
O acesso é limitado.
Código de status HTTP: 429
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
