CreateNamespace - Amazon QuickSight
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CreateNamespace

(édition Enterprise uniquement) Crée un nouvel espace de noms à utiliser avec Amazon QuickSight.

Un espace de noms vous permet d'isoler Amazon QuickSight les utilisateurs et les groupes enregistrés pour cet espace de noms. Les utilisateurs qui accèdent à l'espace de noms peuvent partager des ressources uniquement avec d'autres utilisateurs ou groupes du même espace de noms. Ils ne peuvent pas voir les utilisateurs et les groupes dans les autres espaces de noms. Vous pouvez créer un espace de noms après votreAWScompte est abonné à Amazon QuickSight. L'espace de noms doit être unique dans l'espace de nomsAWS. Par défaut, il y a une limite de 100 espaces de noms parAWS. Pour augmenter votre limite, créez un ticket avecAWS Support.

Syntaxe de la demande

POST /accounts/AwsAccountId HTTP/1.1
Content-type: application/json

{
   "IdentityStore": "string",
   "Namespace": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

AwsAccountId

L'ID pour leAWScompte que vous souhaitez créer Amazon QuickSight espace de noms dans.

Contraintes de longueur : Longueur fixe de 12.

Modèle : ^[0-9]{12}$

Obligatoire : Oui

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

IdentityStore

Spécifie le type de votre répertoire d'identité utilisateur. Actuellement, cela prend en charge les utilisateurs dont le type d'identité estQUICKSIGHT.

Type : Chaîne

Valeurs valides : QUICKSIGHT

Obligatoire : Oui

Namespace

Le nom que vous voulez utiliser pour décrire le nouvel espace de noms.

Type : Chaîne

Contraintes de longueur : Longueur maximale de 64.

Modèle : ^[a-zA-Z0-9._-]*$

Obligatoire : Oui

Tags

Les balises que vous souhaitez associer à l'espace de noms que vous utilisez.

Type : Tableau deTagobjets

Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 200 éléments.

Obligatoire : Non

Syntaxe de la réponse

HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "CapacityRegion": "string",
   "CreationStatus": "string",
   "IdentityStore": "string",
   "Name": "string",
   "RequestId": "string"
}

Eléments de réponse

Si l'action aboutit, le service renvoie la réponse HTTP suivante.

Status

Le statut HTTP de la requête.

Les données suivantes sont renvoyées au format JSON par le service.

Arn

ARN de l'Amazon QuickSight espace de noms que vous avez créé.

Type : Chaîne

CapacityRegion

LeRégion AWS; que vous voulez utiliser pour utiliser la capacité libre de SPICE pour le nouvel espace de noms. Ce paramètre est défini sur la région que vous exécutez CreateNamespace dans.

Type : Chaîne

CreationStatus

État de la création de l'espace de noms. Il s'agit d'un processus asynchrone. Un état deCREATEDsignifie que votre espace de noms est prêt à être utilisée. Si une erreur se produit, elle indique si le processus estretryableounon-retryable. En cas d'erreur ne pouvant pas être réessayée, reportez-vous au message d'erreur pour les tâches de suivi.

Type : Chaîne

Valeurs valides : CREATED | CREATING | DELETING | RETRYABLE_FAILURE | NON_RETRYABLE_FAILURE

IdentityStore

Spécifie le type de votre répertoire d'identité utilisateur. Actuellement, cela prend en charge les utilisateurs dont le type d'identité estQUICKSIGHT.

Type : Chaîne

Valeurs valides : QUICKSIGHT

Name

Le nom du nouvel espace de noms que vous avez créé.

Type : Chaîne

Contraintes de longueur : Longueur maximale de 64.

Modèle : ^[a-zA-Z0-9._-]*$

RequestId

LeAWSID de demande pour cette opération.

Type : Chaîne

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.

AccessDeniedException

Vous n'avez pas accès à cet élément. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès.

Code d'état HTTP : 401

ConflictException

La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.

Code d'état HTTP : 409

InternalFailureException

Une défaillance interne s'est produite.

Code d'état HTTP : 500

InvalidParameterValueException

La valeur d'un ou de plusieurs paramètres n'est pas valide.

Code d'état HTTP : 400

LimitExceededException

Une limite est dépassée.

Code d'état HTTP : 409

PreconditionNotMetException

Une ou plusieurs conditions préalables ne sont pas remplies.

Code d'état HTTP : 400

ResourceExistsException

La ressource spécifiée existe déjà.

Code d'état HTTP : 409

ResourceNotFoundException

Une ou plusieurs ressources n'ont pas pu être trouvées.

Code d'état HTTP : 404

ResourceUnavailableException

Cette ressource n'est pas disponible actuellement.

Code d'état HTTP : 503

ThrottlingException

L'accès est limité.

Code d'état HTTP : 429

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :