Udostępnij za pośrednictwem


Pools - Create Or Update

Twórca lub zaktualizuj określoną pulę pojemności w grupie zasobów
Twórca lub aktualizowanie puli pojemności

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
accountName
path True

string

Nazwa konta usługi NetApp

Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$

poolName
path True

string

Nazwa puli pojemności

Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

uuid

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja geograficzna, w której znajduje się zasób

properties.serviceLevel True

ServiceLevel

serviceLevel
Poziom usług systemu plików

properties.size True

integer

size
Aprowizowany rozmiar puli (w bajtach). Dozwolone wartości znajdują się we fragmentach 1TiB (wartość musi być mnożna 1099511627776).

properties.coolAccess

boolean

W przypadku włączenia (true) pula może zawierać woluminy z włączonym dostępem chłodnym.

properties.encryptionType

encryptionType

encryptionType
Typ szyfrowania puli pojemności, ustaw typ szyfrowania danych magazynowanych dla tej puli i wszystkie woluminy w niej. Tę wartość można ustawić tylko podczas tworzenia nowej puli.

properties.qosType

qosType

qosType
Typ qos puli

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

capacityPool

OK — zaktualizowano pulę

201 Created

capacityPool

Utworzono pulę

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Pools_CreateOrUpdate

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
capacityPool

Zasób puli pojemności

createdByType

Typ tożsamości, która utworzyła zasób.

encryptionType

encryptionType

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

qosType

qosType

ServiceLevel

serviceLevel

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

capacityPool

Zasób puli pojemności

Nazwa Typ Domyślna wartość Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.coolAccess

boolean

False

W przypadku włączenia (true) pula może zawierać woluminy z włączonym dostępem chłodnym.

properties.encryptionType

encryptionType

Single

encryptionType
Typ szyfrowania puli pojemności, ustaw typ szyfrowania danych magazynowanych dla tej puli i wszystkie woluminy w niej. Tę wartość można ustawić tylko podczas tworzenia nowej puli.

properties.poolId

string

poolId
Identyfikator UUID w wersji 4 używany do identyfikowania puli

properties.provisioningState

string

Zarządzanie cyklem życia platformy Azure

properties.qosType

qosType

Auto

qosType
Typ qos puli

properties.serviceLevel

ServiceLevel

Premium

serviceLevel
Poziom usług systemu plików

properties.size

integer

0

size
Aprowizowany rozmiar puli (w bajtach). Dozwolone wartości znajdują się we fragmentach 1TiB (wartość musi być mnożna 1099511627776).

properties.totalThroughputMibps

number

Łączna przepływność puli w usłudze MiB/s

properties.utilizedThroughputMibps

number

Wykorzystanie przepływności puli w usłudze MiB/s

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

encryptionType

encryptionType

Nazwa Typ Opis
Double

string

EncryptionType Double, woluminy będą używać podwójnego szyfrowania danych magazynowanych

Single

string

EncryptionType — pojedynczy, woluminy będą używać pojedynczego szyfrowania danych magazynowanych

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

qosType

qosType

Nazwa Typ Opis
Auto

string

Typ qos Auto

Manual

string

Instrukcja obsługi typów qos

ServiceLevel

serviceLevel

Nazwa Typ Opis
Premium

string

Poziom usług Premium

Standard

string

Poziom usługi w warstwie Standardowa

StandardZRS

string

Poziom usługi magazynu strefowo nadmiarowego

Ultra

string

Poziom usług w warstwie Ultra

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.