Datastores - Update

服務:

Azure Arc enabled VMware

API 版本:

2023-12-01

更新數據存放區。
更新資料存放區資源特定屬性的 API。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/datastores/{datastoreName}?api-version=2023-12-01

URI 參數

名稱	位於	必要	類型	Description
datastoreName	path	True	string	數據存放區的名稱。
resourceGroupName	path	True	string	資源組名。
subscriptionId	path	True	string	訂用帳戶標識碼。
api-version	query	True	string	用戶端 API 版本。

要求本文

名稱	類型	Description
tags	object	資源標籤。

回應

名稱	類型	Description
200 OK	Datastore	Arm 資源更新成功。
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	模擬您的用戶帳戶

範例

UpdateDatastore

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/testrg/providers/Microsoft.ConnectedVMwarevSphere/datastores/HRDatastore?api-version=2023-12-01

{
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  }
}

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ConnectedVMwarevSphere.Models;
using Azure.ResourceManager.ConnectedVMwarevSphere;

// Generated from example definition: specification/connectedvmware/resource-manager/Microsoft.ConnectedVMwarevSphere/stable/2023-12-01/examples/UpdateDatastore.json
// this example is just showing the usage of "Datastores_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VMwareDatastoreResource created on azure
// for more information of creating VMwareDatastoreResource, please refer to the document of VMwareDatastoreResource
string subscriptionId = "fd3c3665-1729-4b7b-9a38-238e83b0f98b";
string resourceGroupName = "testrg";
string datastoreName = "HRDatastore";
ResourceIdentifier vMwareDatastoreResourceId = VMwareDatastoreResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, datastoreName);
VMwareDatastoreResource vMwareDatastore = client.GetVMwareDatastoreResource(vMwareDatastoreResourceId);

// invoke the operation
VMwareResourcePatchContent content = new VMwareResourcePatchContent
{
    Tags =
    {
    ["tag1"] = "value1",
    ["tag2"] = "value2"
    },
};
VMwareDatastoreResource result = await vMwareDatastore.UpdateAsync(content);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
VMwareDatastoreData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:

200

{
  "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/testrg/providers/Microsoft.ConnectedVMwarevSphere/Datastores/HRDatastore",
  "name": "HRDatastore",
  "type": "Microsoft.ConnectedVMwarevSphere/Datastores",
  "location": "East US",
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/a5015e1c-867f-4533-8541-85cd470d0cfb/resourceGroups/demoRG/providers/Microsoft.ExtendedLocation/customLocations/contoso"
  },
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "vCenterId": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/testrg/providers/Microsoft.ConnectedVMwarevSphere/VCenters/ContosoVCenter",
    "moRefId": "aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "provisioningState": "Succeeded"
  }
}

定義

名稱	Description
createdByType	建立資源的身分識別類型。
Datastore	定義資料存放區。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ExtendedLocation	擴充位置。
ProvisioningState	取得布建狀態。
ResourcePatch	包含修補作業更新的物件。
ResourceStatus	資源狀態資訊。
systemData	與建立和上次修改資源相關的元數據。

createdByType

列舉型別

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

值	Description
User
Application
ManagedIdentity
Key

Datastore

Object

定義資料存放區。

名稱	類型	Description
extendedLocation	ExtendedLocation	取得或設定擴充位置。
id	string	取得或設定標識碼。
kind	string	入口網站/工具等用來轉譯相同類型資源的不同UX體驗的元數據;例如，ApiApps 是一種Microsoft.Web/sites 類型。 如果支援，資源提供者必須驗證並保存此值。
location	string	取得或設定位置。
name	string	取得或設定名稱。
properties.capacityGB	integer (int64)	取得或設定 GB 中這個資料存放區的容量上限。
properties.customResourceName	string	取得 Kubernetes 中對應資源的名稱。
properties.freeSpaceGB	integer (int64)	取得或設定此資料存放區在 GB 中的可用空間。
properties.inventoryItemId	string	取得或設定數據存放區的清查專案標識碼。
properties.moName	string	取得或設定數據存放區的 vCenter Managed 物件名稱。
properties.moRefId	string	取得或設定數據存放區的 vCenter MoRef （Managed Object Reference） 識別符。
properties.provisioningState	ProvisioningState	資源布建狀態。
properties.statuses	ResourceStatus[]	資源狀態資訊。
properties.uuid	string	取得或設定此資源的唯一標識符。
properties.vCenterId	string	取得或設定此數據存放區所在 vCenter 資源的 ARM 識別碼。
systemData	systemData	系統數據。
tags	object	取得或設定資源標籤。
type	string	取得或設定資源的型別。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

ExtendedLocation

Object

擴充位置。

名稱	類型	Description
name	string	擴充位置名稱。
type	string	擴充位置類型。

ProvisioningState

列舉型別

取得布建狀態。

值	Description
Succeeded
Failed
Canceled
Provisioning
Updating
Deleting
Accepted
Created

ResourcePatch

Object

包含修補作業更新的物件。

名稱	類型	Description
tags	object	資源標籤。

ResourceStatus

Object

資源狀態資訊。

名稱	類型	Description
lastUpdatedAt	string (date-time)	此條件的上次更新時間。
message	string	人類可讀取的訊息，指出狀態的詳細數據。
reason	string	條件狀態的原因。
severity	string	處理這種狀況失敗的嚴重性。
status	string	條件的狀態。
type	string	條件的類型。

systemData

Object

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

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳 （UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。