共用方式為


Pools - Create Or Update

Create 或更新資源群組內的指定容量集區
Create 或更新容量集區

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

URI 參數

名稱 位於 必要 類型 Description
accountName
path True

string

NetApp 帳戶的名稱

Regex 模式: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$

poolName
path True

string

容量集區的名稱

Regex 模式: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$

resourceGroupName
path True

string

資源群組的名稱。 名稱不區分大小寫。

subscriptionId
path True

string

uuid

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
location True

string

資源所在的地理位置

properties.serviceLevel True

ServiceLevel

serviceLevel
檔系統的服務等級

properties.size True

integer

{1}size{2}
集區 (布建的大小,以位元組為單位) 。 允許的值為 1TiB 區塊, (值必須乘以1099511627776) 。

properties.coolAccess

boolean

如果啟用 (true,) 集區可以包含已啟用非經常性存取的磁碟區。

properties.encryptionType

encryptionType

encryptionType
容量集區的加密類型,針對此集區及其中的所有磁碟區設定待用數據的加密類型。 此值只能在建立新的集區時設定。

properties.qosType

qosType

qosType
集區的qos類型

tags

object

資源標籤。

回應

名稱 類型 Description
200 OK

capacityPool

確定 - 集區已更新

201 Created

capacityPool

集區已建立

Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Pools_CreateOrUpdate

範例要求

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

範例回覆

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

定義

名稱 Description
capacityPool

容量集區資源

createdByType

建立資源的身分識別類型。

encryptionType

encryptionType

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

qosType

qosType

ServiceLevel

serviceLevel

systemData

與建立和上次修改資源相關的元數據。

capacityPool

容量集區資源

名稱 類型 預設值 Description
etag

string

每當更新資源時變更的唯一隻讀字串。

id

string

資源的完整資源識別碼。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

location

string

資源所在的地理位置

name

string

資源的名稱

properties.coolAccess

boolean

False

如果啟用 (true,) 集區可以包含已啟用非經常性存取的磁碟區。

properties.encryptionType

encryptionType

Single

encryptionType
容量集區的加密類型,針對此集區及其中的所有磁碟區設定待用數據的加密類型。 此值只能在建立新的集區時設定。

properties.poolId

string

poolId
用來識別集區的 UUID v4

properties.provisioningState

string

Azure 生命週期管理

properties.qosType

qosType

Auto

qosType
集區的qos類型

properties.serviceLevel

ServiceLevel

Premium

serviceLevel
檔系統的服務等級

properties.size

integer

0

{1}size{2}
集區 (布建的大小,以位元組為單位) 。 允許的值為 1TiB 區塊, (值必須乘以1099511627776) 。

properties.totalThroughputMibps

number

MiB/s 中集區的輸送量總計

properties.utilizedThroughputMibps

number

MiB/s 中集區的已使用輸送量

systemData

systemData

Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。

tags

object

資源標籤。

type

string

資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

createdByType

建立資源的身分識別類型。

名稱 類型 Description
Application

string

Key

string

ManagedIdentity

string

User

string

encryptionType

encryptionType

名稱 類型 Description
Double

string

EncryptionType Double,磁碟區會使用待用雙重加密

Single

string

EncryptionType Single,磁碟區會使用待用單一加密

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

qosType

qosType

名稱 類型 Description
Auto

string

qos 類型自動

Manual

string

qos 類型手動

ServiceLevel

serviceLevel

名稱 類型 Description
Premium

string

進階服務等級

Standard

string

標準服務等級

StandardZRS

string

區域備援記憶體服務等級

Ultra

string

Ultra 服務等級

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string

資源建立的時間戳 (UTC) 。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。