Créer un compte stockage Azure avec l’API REST

Article
08/05/2023

Cet exemple montre comment créer un compte stockage Azure à l’aide de l’API REST Azure.

Une documentation de référence complète et des exemples supplémentaires sont disponibles dans la référence de l’API REST du fournisseur de ressources de stockage.

Générer la demande

Utilisez la requête HTTP PUT suivante pour créer un compte Stockage Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2018-02-01

En-têtes de requête

Les en-têtes suivants sont requis :

En-tête de requête	Description
Content-Type :	Obligatoire. Défini sur `application/json`.
Authorization :	Obligatoire. Défini sur un jeton d’accès`Bearer` valide.

Paramètres URI

Nom	Description
subscriptionId	L’ID d’abonnement d’un abonnement Azure. Si vous avez plusieurs abonnements, consultez Utilisation de plusieurs abonnements.
resourceGroupName	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager, de CLI ou du portail.
accountName	Nom du compte de stockage. Nous vous recommandons de suivre les meilleures pratiques en matière de nommage des comptes .
api-version	Version de l’API à utiliser pour la requête. Ce document aborde la version d’API `2018-02-01`, incluse dans l’URL ci-dessus.

Corps de la demande

Le tableau ci-dessous décrit les propriétés JSON requises pour le corps de la requête. Utilisez des paramètres facultatifs pour personnaliser davantage le compte de stockage.

Nom	Type	Description
location	string	Emplacement de la ressource. Obtenir une liste actuelle des emplacements à l’aide de l’opération Lister les emplacements.
kind	Type	Spécifie le type de compte de stockage à créer. Le choix à usage `StorageV2` général est recommandé et utilisé dans cet exemple.
sku	Sku	Définit les fonctionnalités du compte de stockage, telles que la stratégie de redondance et le chiffrement. Cet exemple utilise le stockage géoredondant.

Exemple de corps de demande

{
  "sku": {
    "name": "Standard_GRS"
  },
  "kind": "StorageV2",
  "location": "eastus2",
}

Gérer la réponse

Les demandes réussies de création d’un compte retournent un code 202 status avec un corps de réponse vide. Le compte de stockage est créé de manière asynchrone. Si le compte existe déjà ou est en cours d’approvisionnement, la réponse à la demande a un code de retour 200 avec la configuration du compte de stockage existant dans le corps de la réponse.

La liste complète des codes de réponse, y compris les codes d’erreur, est disponible dans la documentation de référence sur les codes d’erreur.

Exemple de code de réponse 200

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/res9101/providers/Microsoft.Storage/storageAccounts/{accountName}",
  "kind": "Storage",
  "location": "eastus2",
  "name": "{accountName}",
  "properties": {
    "creationTime": "2017-05-24T13:25:33.4863236Z",
    "primaryEndpoints": {
      "blob": "https://{accountName}.blob.core.windows.net/",
      "file": "https://{accountName}.file.core.windows.net/",
      "queue": "https://{accountName}.queue.core.windows.net/",
      "table": "https://{accountName}.table.core.windows.net/"
    },
    "primaryLocation": "eastus2",
    "provisioningState": "Succeeded",
    "secondaryLocation": "centralus",
    "statusOfPrimary": "available",
    "statusOfSecondary": "available",
    "supportsHttpsTrafficOnly": false
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  },
  "type": "Microsoft.Storage/storageAccounts"
}

Partager via