Condividi tramite


Pools - Create Or Update

Create o Aggiornare il pool di capacità specificato all'interno del gruppo di risorse
Create o Aggiornare un pool di capacità

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
path True

string

Nome dell'account NetApp

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$

poolName
path True

string

Nome del pool di capacità

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$

resourceGroupName
path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

subscriptionId
path True

string

uuid

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
location True

string

Posizione geografica in cui risiede la risorsa

properties.serviceLevel True

ServiceLevel

serviceLevel
Livello di servizio del file system

properties.size True

integer

size
Dimensioni del pool di cui è stato effettuato il provisioning (in byte). I valori consentiti sono in blocchi 1TiB (il valore deve essere moltiplicato per 1099511627776).

properties.coolAccess

boolean

Se abilitato (true) il pool può contenere volumi abilitati per Access ad accesso sporadico.

properties.encryptionType

encryptionType

encryptionType
Tipo di crittografia del pool di capacità, impostare il tipo di crittografia per i dati inattivi per questo pool e tutti i volumi in esso contenuti. Questo valore può essere impostato solo quando si crea un nuovo pool.

properties.qosType

qosType

qosType
Tipo qos del pool

tags

object

Tag delle risorse.

Risposte

Nome Tipo Descrizione
200 OK

capacityPool

OK - Pool aggiornato

201 Created

capacityPool

Pool creato

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Pools_CreateOrUpdate

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
capacityPool

Risorsa pool di capacità

createdByType

Tipo di identità che ha creato la risorsa.

encryptionType

encryptionType

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

qosType

qosType

ServiceLevel

serviceLevel

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

capacityPool

Risorsa pool di capacità

Nome Tipo Valore predefinito Descrizione
etag

string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.

id

string

ID di risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Posizione geografica in cui risiede la risorsa

name

string

nome della risorsa.

properties.coolAccess

boolean

False

Se abilitato (true) il pool può contenere volumi abilitati per Access ad accesso sporadico.

properties.encryptionType

encryptionType

Single

encryptionType
Tipo di crittografia del pool di capacità, impostare il tipo di crittografia per i dati inattivi per questo pool e tutti i volumi in esso contenuti. Questo valore può essere impostato solo quando si crea un nuovo pool.

properties.poolId

string

poolId
UUID v4 usato per identificare il pool

properties.provisioningState

string

Gestione del ciclo di vita di Azure

properties.qosType

qosType

Auto

qosType
Tipo qos del pool

properties.serviceLevel

ServiceLevel

Premium

serviceLevel
Livello di servizio del file system

properties.size

integer

0

size
Dimensioni del pool di cui è stato effettuato il provisioning (in byte). I valori consentiti sono in blocchi 1TiB (il valore deve essere moltiplicato per 1099511627776).

properties.totalThroughputMibps

number

Velocità effettiva totale del pool in MiB/s

properties.utilizedThroughputMibps

number

Velocità effettiva utilizzata del pool in MiB/s

systemData

systemData

Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy.

tags

object

Tag delle risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

encryptionType

encryptionType

Nome Tipo Descrizione
Double

string

EncryptionType Double, i volumi useranno la doppia crittografia dei dati inattivi

Single

string

EncryptionType Single, i volumi useranno una sola crittografia dei dati inattivi

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

qosType

qosType

Nome Tipo Descrizione
Auto

string

Tipo qos Auto

Manual

string

Qos type Manual

ServiceLevel

serviceLevel

Nome Tipo Descrizione
Premium

string

Livello di servizio Premium

Standard

string

Livello di servizio Standard

StandardZRS

string

Livello di servizio di archiviazione con ridondanza della zona

Ultra

string

Livello di servizio Ultra

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.