CreateNamespace - - Centre de documentation Alibaba Cloud

Crée un espace de noms.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

sae:CreateNamespace

create

*All Resource

*

Aucune

Syntaxe de la requête

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

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
NamespaceId	string	Non	L'identifiant d'espace de noms au format long. Si vous spécifiez ce paramètre, NameSpaceShortId est ignoré. Ce paramètre est conservé pour des raisons de compatibilité. Utilisez plutôt l'identifiant d'espace de noms au format court. Le format est `<RegionId>:<NamespaceId>`. Le `NamespaceId` ne peut contenir que des lettres minuscules et des chiffres, et sa longueur ne peut pas dépasser 32 caractères. Exemple : `cn-beijing:test`. Pour plus d'informations sur les régions prises en charge par SAE, consultez DescribeRegions.	cn-beijing:test
NamespaceName	string	Oui	Le nom de l'espace de noms. Le nom ne peut pas dépasser 64 caractères.	name
NamespaceDescription	string	Non	La description de l'espace de noms. La description ne peut pas dépasser 100 caractères.	desc
NameSpaceShortId	string	Non	L'identifiant d'espace de noms au format court. Vous n'avez pas besoin de spécifier d'identifiant de région. Ce paramètre est recommandé. L'identifiant ne peut pas dépasser 20 caractères et ne peut contenir que des lettres minuscules et des chiffres.	test
EnableMicroRegistration	boolean	Non	Indique si le registre de services intégré de SAE doit être activé. true false La valeur par défaut est true. Si vous n'utilisez pas le registre de services intégré, définissez ce paramètre sur false pour accélérer la création de l'espace de noms.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les données renvoyées.
RequestId	string	L'identifiant de la requête.	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	Les informations supplémentaires renvoyées.	success
TraceId	string	L'identifiant de trace. Vous pouvez utiliser l'identifiant de trace pour interroger les détails d'une requête.	0a981dd515966966104121683d****
Data	object	Les informations relatives à l'espace de noms.
NamespaceDescription	string	La description de l'espace de noms.	desc
NamespaceId	string	L'identifiant de l'espace de noms.	cn-beijing:test
NamespaceName	string	Le nom de l'espace de noms.	name
RegionId	string	La région à laquelle appartient l'espace de noms.	cn-beijing
NameSpaceShortId	string	L'identifiant d'espace de noms au format court.	test
EnableMicroRegistration	boolean	Indique si le registre de services intégré de SAE est activé. true false	true
ErrorCode	string	Le code d'erreur. Si la requête aboutit, ce paramètre n'est pas renvoyé. Si la requête échoue, ce paramètre est renvoyé. Pour plus d'informations, consultez la section Codes d'erreur de cette rubrique.
Code	string	Le code d'état HTTP ou un code d'erreur POP. Valeurs valides : 2xx : La requête a abouti. 3xx : La requête a été redirigée. 4xx : Une erreur de requête s'est produite. 5xx : Une erreur de serveur s'est produite.	200
Success	boolean	Indique si l'espace de noms a été créé avec succès. Valeurs valides : true : L'espace de noms a été créé. false : La création de l'espace de noms a échoué.	true

Exemples

JSON format

{
  "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
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.