你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Storage Appliances - Update

可以独立完成提供的存储设备的属性或与存储设备属性和标记更新关联的更新标记。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}?api-version=2025-09-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

minLength: 1
maxLength: 90

资源组的名称。 此名称不区分大小写。

storageApplianceName
path True

string

pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$

存储设备的名称。

subscriptionId
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

StorageAppliance

Azure 运营顺利完成。

202 Accepted

接受资源更新请求。

标头

  • Azure-AsyncOperation: string
  • Location: string
Other Status Codes

ErrorResponse

意外错误响应。

安全性

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

定义

名称 说明
AdministrativeCredentials

AdministrativeCredentials 表示需要基于密码的身份验证的设备的管理员凭据。

Azure.ResourceManager.CommonTypes.ExtendedLocation

扩展位置的复杂类型。

CertificateInfo

CertificateInfo 表示 X.509 证书的非专用信息。

createdByType

创建资源的标识的类型。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

ExtendedLocationType

扩展位置的类型。

RemoteVendorManagementFeature

存储设备是否支持远程供应商管理的指示器。

RemoteVendorManagementStatus

指示远程供应商管理功能是启用还是禁用,或者如果是不受支持的功能,则不支持。

SecretArchiveReference

SecretArchiveReference 表示对密钥保管库中机密的引用。

SecretRotationStatus

SecretRotationStatus 表示机密轮换的状态。

StorageAppliance

StorageAppliance 表示本地网络云存储设备。

StorageApplianceDetailedStatus

存储设备的详细状态。

StorageAppliancePatchParameters

StorageAppliancePatchParameters 表示修补存储设备属性的请求正文。

StorageApplianceProvisioningState

存储设备的配置状态。

systemData

与创建和上次修改资源相关的元数据。

AdministrativeCredentials

AdministrativeCredentials 表示需要基于密码的身份验证的设备的管理员凭据。

名称 类型 说明
password

string (password)

minLength: 1

初始化期间使用的设备的管理员的密码。

username

string

minLength: 1

初始化期间使用的设备的管理员用户名。

Azure.ResourceManager.CommonTypes.ExtendedLocation

扩展位置的复杂类型。

名称 类型 说明
name

string

扩展位置的名称。

type

ExtendedLocationType

扩展位置的类型。

CertificateInfo

CertificateInfo 表示 X.509 证书的非专用信息。

名称 类型 说明
hash

string

X.509 证书的哈希值。

value

string

X.509 证书的文本值。

createdByType

创建资源的标识的类型。

说明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

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

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

Azure.ResourceManager.CommonTypes.ExtendedLocation

资源的扩展位置。 创建资源时需要该属性。

id

string (arm-id)

资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

location

string

资源所在的地理位置

name

string

资源的名称

properties.administratorCredentials

AdministrativeCredentials

此存储设备上的管理接口的凭据。

properties.caCertificate

CertificateInfo

平台颁发的用于连接存储设备的 TLS 接口的 CA 证书信息。 调用方将此证书添加到其受信任的 CA 存储中,以允许与存储设备进行安全通信。

properties.capacity

integer (int64)

存储设备的总容量。 以 GiB 为单位测量。

properties.capacityUsed

integer (int64)

消耗的存储量。 以 GiB 为单位测量。

properties.clusterId

string (arm-id)

与此存储设备关联的集群的资源 ID。

properties.detailedStatus

StorageApplianceDetailedStatus

存储设备的详细状态。

properties.detailedStatusMessage

string

有关当前详细状态的描述性消息。

properties.managementIpv4Address

string

存储设备管理界面的端点。

properties.manufacturer

string

存储设备的制造商。

properties.model

string

存储设备的型号。

properties.provisioningState

StorageApplianceProvisioningState

存储设备的配置状态。

properties.rackId

string (arm-id)

此存储设备所在的机架的资源 ID。

properties.rackSlot

integer (int64)

minimum: 1
maximum: 256

存储设备的槽基于 BOM 配置在机架中。

properties.remoteVendorManagementFeature

RemoteVendorManagementFeature

存储设备是否支持远程供应商管理的指示器。

properties.remoteVendorManagementStatus

RemoteVendorManagementStatus

指示远程供应商管理功能是启用还是禁用,或者如果是不受支持的功能,则不支持。

properties.secretRotationStatus

SecretRotationStatus[]

表示机密轮换活动的状态列表。

properties.serialNumber

string

存储设备的序列号。

properties.storageApplianceSkuId

string

存储设备的 SKU。

properties.version

string

存储设备的版本。

systemData

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

createdByType

创建资源的标识的类型。

lastModifiedAt

string (date-time)

上次修改的资源时间戳(UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识的类型。