Partager via


Pools - Create Or Update

Create ou mettre à jour le pool de capacité spécifié dans le groupe de ressources
Create ou Mettre à jour un pool de capacités

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}?api-version=2023-11-01

Paramètres URI

Nom Dans Obligatoire Type Description
accountName
path True

string

Nom du compte NetApp

Modèle d’expression régulière: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$

poolName
path True

string

Nom du pool de capacités

Modèle d’expression régulière: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$

resourceGroupName
path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string

uuid

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource

properties.serviceLevel True

ServiceLevel

serviceLevel
Niveau de service du système de fichiers

properties.size True

integer

taille
Taille provisionnée du pool (en octets). Les valeurs autorisées sont en blocs 1TiB (la valeur doit être multipliée par 1099511627776).

properties.coolAccess

boolean

Si cette option est activée (true), le pool peut contenir des volumes activés pour l’accès.

properties.encryptionType

encryptionType

encryptionType
Type de chiffrement du pool de capacité, définissez le type de chiffrement des données au repos pour ce pool et tous les volumes qu’il contient. Cette valeur ne peut être définie que lors de la création d’un pool.

properties.qosType

qosType

qosType
Type qos du pool

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

capacityPool

OK - Pool mis à jour

201 Created

capacityPool

Pool créé

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Pools_CreateOrUpdate

Exemple de requête

PUT https://management.azure.com/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1?api-version=2023-11-01

{
  "location": "eastus",
  "properties": {
    "size": 4398046511104,
    "serviceLevel": "Premium",
    "qosType": "Auto"
  }
}

Exemple de réponse

{
  "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1",
  "name": "account1/pool1",
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded",
    "poolId": "9760acf5-4638-11e7-9bdb-020073ca7778",
    "serviceLevel": "Premium",
    "size": 4398046511104,
    "qosType": "Auto",
    "totalThroughputMibps": 281.474
  }
}
{
  "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1",
  "name": "account1/pool1",
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded",
    "poolId": "9760acf5-4638-11e7-9bdb-020073ca7778",
    "serviceLevel": "Premium",
    "size": 4398046511104,
    "qosType": "Auto",
    "totalThroughputMibps": 281.474
  }
}

Définitions

Nom Description
capacityPool

Ressource de pool de capacité

createdByType

Type d’identité qui a créé la ressource.

encryptionType

encryptionType

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

qosType

qosType

ServiceLevel

serviceLevel

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

capacityPool

Ressource de pool de capacité

Nom Type Valeur par défaut Description
etag

string

Chaîne unique en lecture seule qui change chaque fois que la ressource est mise à jour.

id

string

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

location

string

Emplacement géographique où réside la ressource

name

string

nom de la ressource.

properties.coolAccess

boolean

False

Si cette option est activée (true), le pool peut contenir des volumes activés pour l’accès.

properties.encryptionType

encryptionType

Single

encryptionType
Type de chiffrement du pool de capacité, définissez le type de chiffrement des données au repos pour ce pool et tous les volumes qu’il contient. Cette valeur ne peut être définie que lors de la création d’un pool.

properties.poolId

string

poolId
UUID v4 utilisé pour identifier le pool

properties.provisioningState

string

Gestion du cycle de vie Azure

properties.qosType

qosType

Auto

qosType
Type qos du pool

properties.serviceLevel

ServiceLevel

Premium

serviceLevel
Niveau de service du système de fichiers

properties.size

integer

0

taille
Taille provisionnée du pool (en octets). Les valeurs autorisées sont en blocs 1TiB (la valeur doit être multipliée par 1099511627776).

properties.totalThroughputMibps

number

Débit total du pool en Mio/s

properties.utilizedThroughputMibps

number

Débit utilisé du pool en Mio/s

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

encryptionType

encryptionType

Nom Type Description
Double

string

EncryptionType Double, les volumes utilisent le double chiffrement au repos

Single

string

EncryptionType Single, les volumes utilisent le chiffrement unique au repos

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

qosType

qosType

Nom Type Description
Auto

string

Qos type Auto

Manual

string

Manuel de type qos

ServiceLevel

serviceLevel

Nom Type Description
Premium

string

Niveau de service Premium

Standard

string

Niveau de service standard

StandardZRS

string

Niveau de service de stockage redondant interzone

Ultra

string

Niveau de service Ultra

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la dernière ressource.

lastModifiedByType

createdByType

Type d’identité qui a modifié la dernière ressource.