CreateNamespace - Serverless App Engine: Central de Documentação do Alibaba Cloud

Cria um namespace.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

sae:CreateNamespace

create

*All Resource

*

Nenhuma

Sintaxe da solicitação

POST /pop/v1/paas/namespace HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
NamespaceId	string	Não	O ID do namespace no formato longo. Se você especificar este parâmetro, NameSpaceShortId será ignorado. Este parâmetro é mantido para compatibilidade. Use o ID do namespace no formato curto. O formato é :. O NamespaceId pode conter apenas letras minúsculas e dígitos e não pode exceder 32 caracteres de comprimento. Exemplo: cn-beijing:test. Para obter informações sobre as regiões compatíveis com o SAE, consulte DescribeRegions.	cn-beijing:test
NamespaceName	string	Sim	O nome do namespace. O nome não pode exceder 64 caracteres de comprimento.	name
NamespaceDescription	string	Não	A descrição do namespace. A descrição não pode exceder 100 caracteres de comprimento.	desc
NameSpaceShortId	string	Não	O ID do namespace no formato curto. Você não precisa especificar um ID de região. Este parâmetro é recomendado. O ID não pode exceder 20 caracteres de comprimento e pode conter apenas letras minúsculas e dígitos.	test
EnableMicroRegistration	boolean	Não	Especifica se o registro de serviço integrado do SAE deve ser ativado. true false Valor padrão: true. Se você não usar o registro de serviço integrado, defina este parâmetro como false para acelerar a criação do namespace.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	As informações adicionais retornadas.	success
TraceId	string	O ID de rastreamento. Você pode usar o ID de rastreamento para consultar os detalhes de uma solicitação.	0a981dd515966966104121683d****
Data	object	As informações sobre o namespace.
NamespaceDescription	string	A descrição do namespace.	desc
NamespaceId	string	O ID do namespace.	cn-beijing:test
NamespaceName	string	O nome do namespace.	name
RegionId	string	A região onde o namespace reside.	cn-beijing
NameSpaceShortId	string	O ID do namespace no formato curto.	test
EnableMicroRegistration	boolean	Indica se o registro de serviço integrado do SAE está ativado. true false	true
ErrorCode	string	O código de erro. Se a solicitação for bem-sucedida, este parâmetro não será retornado. Se a solicitação falhar, este parâmetro será retornado. Para obter mais informações, consulte a seção Códigos de erro neste tópico.
Code	string	O código de status HTTP ou um código de erro POP. Valores válidos: 2xx: A solicitação foi bem-sucedida. 3xx: A solicitação foi redirecionada. 4xx: Ocorreu um erro de solicitação. 5xx: Ocorreu um erro de servidor.	200
Success	boolean	Indica se o namespace foi criado com sucesso. Valores válidos: true: O namespace foi criado. false: Falha ao criar o namespace.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a981dd515966966104121683d****",
  "Data": {
    "NamespaceDescription": "desc",
    "NamespaceId": "cn-beijing:test",
    "NamespaceName": "name",
    "RegionId": "cn-beijing",
    "NameSpaceShortId": "test",
    "EnableMicroRegistration": true
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InstanceExist.NamespaceId	The specified namespace ID already exists.	The specified namespace ID already exists.
400	InvalidNamespace.WithUppercase	This namespace does not support creating SAE apps because it contains uppercase letters.
400	InvalidNamespaceId.Format	The specified NamespaceId is invalid.	The specified NamespaceId is invalid. The correct format is [regionId]:[namespace]. For example, cn-beijing:test. NamespaceId cannot exceed 32 characters in length.
400	InvalidNamespaceIdSuffix.Format	The specified NamespaceId is invalid. NamespaceId can only contain alphabetical letters or numbers.	The specified NamespaceId is invalid. NamespaceId can only contain alphabetical letters or numbers.
400	InvalidNamespaceName.Format	The specified NamespaceName is invalid. The name of the namespace cannot exceed 63 characters in length.	The specified NamespaceName is invalid. The name of the namespace cannot exceed 63 characters in length.
400	InvalidOperation.NamespaceClusterNotDeleted	The specified NamespaceId contains clusters.	The specified NamespaceId contains clusters.
400	Namespace.AppExists	Please delete the application first.
400	System.Upgrading	The system is being upgraded. Please try again later.
400	Exceed.Namespace	Too many namespaces have been created.
500	OperationFailed.DauthHttpRequest	request dauth failed.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.