CreateNamespace - Serverless App Engine - Centro de documentación de Alibaba Cloud

Crea un espacio de nombres.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

sae:CreateNamespace

create

*All Resource

*

Ninguna

Sintaxis de la solicitud

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

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
NamespaceId	string	No	El ID del espacio de nombres en formato largo. Si especifica este parámetro, se ignora NameSpaceShortId. Este parámetro se conserva por compatibilidad. Utilice el ID del espacio de nombres en formato corto en su lugar. El formato es `<RegionId>:<NamespaceId>`. El `NamespaceId` solo puede contener letras minúsculas y dígitos, y no puede exceder los 32 caracteres de longitud. Ejemplo: `cn-beijing:test`. Para obtener información sobre las regiones que admite SAE, consulte DescribeRegions.	cn-beijing:test
NamespaceName	string	Sí	El nombre del espacio de nombres. El nombre no puede exceder los 64 caracteres de longitud.	name
NamespaceDescription	string	No	La descripción del espacio de nombres. La descripción no puede exceder los 100 caracteres de longitud.	desc
NameSpaceShortId	string	No	El ID del espacio de nombres en formato corto. No es necesario especificar un ID de región. Se recomienda utilizar este parámetro. El ID no puede exceder los 20 caracteres de longitud y solo puede contener letras minúsculas y dígitos.	test
EnableMicroRegistration	boolean	No	Especifica si se debe habilitar el registro de servicios integrado de SAE. true false El valor predeterminado es true. Si no utiliza el registro de servicios integrado, establezca este parámetro en false para acelerar la creación del espacio de nombres.	true

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los datos devueltos.
RequestId	string	El ID de la solicitud.	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	La información adicional devuelta.	success
TraceId	string	El ID de seguimiento. Puede utilizar el ID de seguimiento para consultar los detalles de una solicitud.	0a981dd515966966104121683d****
Data	object	La información sobre el espacio de nombres.
NamespaceDescription	string	La descripción del espacio de nombres.	desc
NamespaceId	string	El ID del espacio de nombres.	cn-beijing:test
NamespaceName	string	El nombre del espacio de nombres.	name
RegionId	string	La región donde reside el espacio de nombres.	cn-beijing
NameSpaceShortId	string	El ID del espacio de nombres en formato corto.	test
EnableMicroRegistration	boolean	Indica si el registro de servicios integrado de SAE está habilitado. true false	true
ErrorCode	string	El código de error. Si la solicitud se realiza correctamente, no se devuelve este parámetro. Si la solicitud falla, se devuelve este parámetro. Para obtener más información, consulte la sección Códigos de error en este tema.
Code	string	El código de estado HTTP o un código de error POP. Valores válidos: 2xx: La solicitud se realizó correctamente. 3xx: La solicitud se redirigió. 4xx: Ocurrió un error en la solicitud. 5xx: Ocurrió un error en el servidor.	200
Success	boolean	Indica si el espacio de nombres se creó correctamente. Valores válidos: true: El espacio de nombres se creó. false: No se pudo crear el espacio de nombres.	true

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.