Storage Appliances - Update
可以独立完成提供的存储设备的属性或与存储设备属性和标记更新关联的更新标记。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}?api-version=2025-09-01
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
资源组的名称。 此名称不区分大小写。 |
|
storage
|
path | True |
string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ |
存储设备的名称。 |
|
subscription
|
path | True |
string (uuid) |
目标订阅的 ID。 该值必须是 UUID。 |
|
api-version
|
query | True |
string minLength: 1 |
用于此操作的 API 版本。 |
请求头
| 名称 | 必需 | 类型 | 说明 |
|---|---|---|---|
| If-Match |
string |
转换的 ETag。 省略此值以始终覆盖当前资源。 指定最后一次看到的 ETag 值,以防止意外覆盖并发更改。 |
|
| If-None-Match |
string |
设置为“*”以允许创建新记录集,但要防止更新现有资源。 其他值将导致服务器出错,因为它们不受支持。 |
请求正文
| 名称 | 类型 | 说明 |
|---|---|---|
| properties.serialNumber |
string |
存储设备的序列号。 |
| tags |
object |
资源标记。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
Azure 运营顺利完成。 |
|
| 202 Accepted |
接受资源更新请求。 标头
|
|
| Other Status Codes |
意外错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
| 名称 | 说明 |
|---|---|
| user_impersonation | 模拟用户帐户 |
示例
Patch storage appliance
示例请求
PATCH https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/storageAppliances/storageApplianceName?api-version=2025-09-01
{
"properties": {
"serialNumber": "BM1219XXX"
},
"tags": {
"key1": "myvalue1",
"key2": "myvalue2"
}
}
示例响应
{
"extendedLocation": {
"name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
"type": "CustomLocation"
},
"id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/storageAppliances/storageApplianceName",
"location": "location",
"name": "storageApplianceName",
"properties": {
"administratorCredentials": {
"username": "adminUser"
},
"caCertificate": {
"hash": "dea698309efd2830a1d440a807650d9aa6d954b3243ab8cb556ac98c1f3faa60",
"value": "-----BEGIN CERTIFICATE-----\nMIIDXTCCAkWgAwIBAgIJAL4a5b1d8f2wM...A0GCSqGSIb3DQEBCwUAMEUxCzAJB==\n-----END CERTIFICATE-----"
},
"capacity": 893,
"capacityUsed": 500,
"clusterId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName",
"detailedStatus": "Available",
"detailedStatusMessage": "Storage appliance is up and running",
"managementIpv4Address": "192.0.2.2",
"manufacturer": "Contoso Storage",
"model": "ArrayStore-Flash70",
"provisioningState": "Succeeded",
"rackId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName",
"rackSlot": 1,
"remoteVendorManagementFeature": "Supported",
"remoteVendorManagementStatus": "Enabled",
"secretRotationStatus": [
{
"expirePeriodDays": 90,
"lastRotationTime": "2023-09-30T13:27:23.103Z",
"rotationPeriodDays": 60,
"secretArchiveReference": {
"keyVaultId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.KeyVault/vaults/keyVaultName",
"secretName": "ffffffff-ffff-ffff-ffff-ffffffffffff-resource-group-cluster-1679871-storage-appliance-credential-manager-ffffffff",
"secretVersion": "02ab6c1f9c0f4982b0632b0d5d74a33b"
},
"secretType": "Storage Appliance User"
}
],
"serialNumber": "BM1219XXX",
"storageApplianceSkuId": "684E-3B16-399E",
"version": "9.9.9"
},
"systemData": {
"createdAt": "2021-01-22T13:27:03.008Z",
"createdBy": "identityA",
"createdByType": "Application",
"lastModifiedAt": "2021-01-22T13:29:03.001Z",
"lastModifiedBy": "identityB",
"lastModifiedByType": "User"
},
"tags": {
"key1": "myvalue1",
"key2": "myvalue2"
},
"type": "Microsoft.NetworkCloud/storageAppliances"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2025-09-01
Location: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2025-09-01
定义
| 名称 | 说明 |
|---|---|
|
Administrative |
AdministrativeCredentials 表示需要基于密码的身份验证的设备的管理员凭据。 |
|
Azure. |
扩展位置的复杂类型。 |
|
Certificate |
CertificateInfo 表示 X.509 证书的非专用信息。 |
|
created |
创建资源的标识的类型。 |
|
Error |
资源管理错误附加信息。 |
|
Error |
错误详细信息。 |
|
Error |
错误响应 |
|
Extended |
扩展位置的类型。 |
|
Remote |
存储设备是否支持远程供应商管理的指示器。 |
|
Remote |
指示远程供应商管理功能是启用还是禁用,或者如果是不受支持的功能,则不支持。 |
|
Secret |
SecretArchiveReference 表示对密钥保管库中机密的引用。 |
|
Secret |
SecretRotationStatus 表示机密轮换的状态。 |
|
Storage |
StorageAppliance 表示本地网络云存储设备。 |
|
Storage |
存储设备的详细状态。 |
|
Storage |
StorageAppliancePatchParameters 表示修补存储设备属性的请求正文。 |
|
Storage |
存储设备的配置状态。 |
|
system |
与创建和上次修改资源相关的元数据。 |
AdministrativeCredentials
AdministrativeCredentials 表示需要基于密码的身份验证的设备的管理员凭据。
| 名称 | 类型 | 说明 |
|---|---|---|
| password |
string (password) minLength: 1 |
初始化期间使用的设备的管理员的密码。 |
| username |
string minLength: 1 |
初始化期间使用的设备的管理员用户名。 |
Azure.ResourceManager.CommonTypes.ExtendedLocation
扩展位置的复杂类型。
| 名称 | 类型 | 说明 |
|---|---|---|
| name |
string |
扩展位置的名称。 |
| type |
扩展位置的类型。 |
CertificateInfo
CertificateInfo 表示 X.509 证书的非专用信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| hash |
string |
X.509 证书的哈希值。 |
| value |
string |
X.509 证书的文本值。 |
createdByType
创建资源的标识的类型。
| 值 | 说明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
资源管理错误附加信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| info |
object |
其他信息。 |
| type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
错误附加信息。 |
|
| code |
string |
错误代码。 |
| details |
错误详细信息。 |
|
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorResponse
错误响应
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误对象。 |
ExtendedLocationType
扩展位置的类型。
| 值 | 说明 |
|---|---|
| EdgeZone |
Azure 边缘区域位置类型 |
| CustomLocation |
Azure 自定义位置类型 |
RemoteVendorManagementFeature
存储设备是否支持远程供应商管理的指示器。
| 值 | 说明 |
|---|---|
| Supported |
支持远程供应商管理。 |
| Unsupported |
不支持远程供应商管理。 |
RemoteVendorManagementStatus
指示远程供应商管理功能是启用还是禁用,或者如果是不受支持的功能,则不支持。
| 值 | 说明 |
|---|---|
| Enabled |
已启用远程供应商管理。 |
| Disabled |
远程供应商管理被禁用。 |
| Unsupported |
不支持远程供应商管理。 |
SecretArchiveReference
SecretArchiveReference 表示对密钥保管库中机密的引用。
| 名称 | 类型 | 说明 |
|---|---|---|
| keyVaultId |
string (arm-id) |
包含机密的密钥保管库的资源 ID。 |
| keyVaultUri |
string (uri) |
包含机密的密钥的 URI。 |
| secretName |
string |
密钥保管库中机密的名称。 |
| secretVersion |
string |
密钥保管库中机密的版本。 |
SecretRotationStatus
SecretRotationStatus 表示机密轮换的状态。
| 名称 | 类型 | 说明 |
|---|---|---|
| expirePeriodDays |
integer (int64) |
在必须更改密钥之前可以使用的最大天数。 |
| lastRotationTime |
string (date-time) |
上次更改密钥的日期和时间。 |
| rotationPeriodDays |
integer (int64) |
在尝试轮换之前,机密存在的天数。 |
| secretArchiveReference |
对密钥保管库中机密的引用。 |
|
| secretType |
string |
用于标识机密用途的类型名称。 |
StorageAppliance
StorageAppliance 表示本地网络云存储设备。
| 名称 | 类型 | 说明 |
|---|---|---|
| etag |
string |
“如果在响应正文中提供了 etag,则也可以根据正常的 etag 约定将其作为标头提供。 实体标记用于比较同一请求资源的两个或多个实体。 HTTP/1.1 在 etag(第 14.19 节)、If-Match(第 14.24 节)、If-None-Match(第 14.26 节)和 If-Range(第 14.27 节)标头字段中使用实体标签。 |
| extendedLocation |
资源的扩展位置。 创建资源时需要该属性。 |
|
| id |
string (arm-id) |
资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
| location |
string |
资源所在的地理位置 |
| name |
string |
资源的名称 |
| properties.administratorCredentials |
此存储设备上的管理接口的凭据。 |
|
| properties.caCertificate |
平台颁发的用于连接存储设备的 TLS 接口的 CA 证书信息。 调用方将此证书添加到其受信任的 CA 存储中,以允许与存储设备进行安全通信。 |
|
| properties.capacity |
integer (int64) |
存储设备的总容量。 以 GiB 为单位测量。 |
| properties.capacityUsed |
integer (int64) |
消耗的存储量。 以 GiB 为单位测量。 |
| properties.clusterId |
string (arm-id) |
与此存储设备关联的集群的资源 ID。 |
| properties.detailedStatus |
存储设备的详细状态。 |
|
| properties.detailedStatusMessage |
string |
有关当前详细状态的描述性消息。 |
| properties.managementIpv4Address |
string |
存储设备管理界面的端点。 |
| properties.manufacturer |
string |
存储设备的制造商。 |
| properties.model |
string |
存储设备的型号。 |
| properties.provisioningState |
存储设备的配置状态。 |
|
| properties.rackId |
string (arm-id) |
此存储设备所在的机架的资源 ID。 |
| properties.rackSlot |
integer (int64) minimum: 1maximum: 256 |
存储设备的槽基于 BOM 配置在机架中。 |
| properties.remoteVendorManagementFeature |
存储设备是否支持远程供应商管理的指示器。 |
|
| properties.remoteVendorManagementStatus |
指示远程供应商管理功能是启用还是禁用,或者如果是不受支持的功能,则不支持。 |
|
| properties.secretRotationStatus |
表示机密轮换活动的状态列表。 |
|
| properties.serialNumber |
string |
存储设备的序列号。 |
| properties.storageApplianceSkuId |
string |
存储设备的 SKU。 |
| properties.version |
string |
存储设备的版本。 |
| systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
| tags |
object |
资源标记。 |
| type |
string |
资源类型。 例如,“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
StorageApplianceDetailedStatus
存储设备的详细状态。
| 值 | 说明 |
|---|---|
| Available |
可用性状态。 |
| Degraded |
降级状态。 |
| Error |
错误状态。 |
| Provisioning |
配置状态。 |
StorageAppliancePatchParameters
StorageAppliancePatchParameters 表示修补存储设备属性的请求正文。
| 名称 | 类型 | 说明 |
|---|---|---|
| properties.serialNumber |
string |
存储设备的序列号。 |
| tags |
object |
资源标记。 |
StorageApplianceProvisioningState
存储设备的配置状态。
| 值 | 说明 |
|---|---|
| Succeeded |
继承状态。 |
| Failed |
失败状态。 |
| Canceled |
取消状态。 |
| Provisioning |
配置状态。 |
| Accepted |
接受状态。 |
systemData
与创建和上次修改资源相关的元数据。
| 名称 | 类型 | 说明 |
|---|---|---|
| createdAt |
string (date-time) |
资源创建时间戳(UTC)。 |
| createdBy |
string |
创建资源的标识。 |
| createdByType |
创建资源的标识的类型。 |
|
| lastModifiedAt |
string (date-time) |
上次修改的资源时间戳(UTC) |
| lastModifiedBy |
string |
上次修改资源的标识。 |
| lastModifiedByType |
上次修改资源的标识的类型。 |