Virtual Clusters - Update

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

仮想クラスターを更新します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/virtualClusters/{virtualClusterName}?api-version=2021-11-01

URI パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー API またはポータルから取得できます。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
virtualClusterName	path	True	string	仮想クラスターの名前。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	型	説明
properties.family	string	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。
properties.maintenanceConfigurationId	string	この仮想クラスターに適用するメンテナンス構成 ID を指定します。
tags	object	リソースタグ。

応答

名前	型	説明
200 OK	VirtualCluster	仮想クラスターが正常に更新されました。
202 Accepted		仮想クラスターの更新が進行中です。
Other Status Codes		エラー応答: *** 400 SubscriptionNotEnabledForFeature - 機能ユーザーが使用しようとしたユーザーサブスクリプションが有効になっていません。 400 ManagementServiceFeatureDisabled - ユーザーが無効になっている機能を使用しようとしました。 400 InvalidMaintenanceWindowSettings - メンテナンス期間の設定が無効です。 400 InvalidMaintenanceWindowProperty - メンテナンス期間のプロパティが無効です。 400 InvalidMaintenanceWindowPropertyNull - 必要なプロパティが null のメンテナンス期間が無効です。 400 InvalidMaintenanceWindowTypeWithPropertySpecified - メンテナンス期間の種類に特定のプロパティを指定することはできません。 400 UpdateOfParameterNotSupported - '{0}' の更新はサポートされていません。 404 VirtualClusterDoesNotExist - 仮想クラスターが存在しません。 404 ResourceDoesNotExist - 名前 '{0}' のリソースが存在しません。続行するには、有効なリソース名を指定します。 404 VirtualClusterNotInSubscriptionResourceGroup - 指定されたリソースグループとサブスクリプションに、指定された仮想クラスターが存在しません。 404 SubscriptionNotFound - 要求されたサブスクリプションが見つかりませんでした。 404 SubscriptionDoesNotHaveVirtualCluster - 要求された仮想クラスターが見つかりませんでした 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。 404 OperationIdNotFound - Id を持つ操作が存在しません。 409 VirtualClusterRemovalAlreadyInProgress - 仮想クラスターの削除は既に進行中です。仮想クラスターは、最初のインスタンスの作成で自動的に作成され、最後のインスタンスの削除と共に自動的に削除されます。詳細情報: https://aka.ms/sqlmi-virtual-cluster-removal。 409 VirtualClusterIsNotEmpty - 仮想クラスターは空ではなく、削除できません。 409 VirtualClusterIsBusy - 仮想クラスターは現在ビジー状態です。後で操作を再試行してください。 409 VirtualClusterRemovalFailed - 仮想クラスターの削除要求に失敗しました。アクティブな依存リソースがあるかどうかを確認します。 409 ConflictingVirtualClusterOperation - 仮想クラスターの操作は現在進行中です。 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 ConflictingSubscriptionOperation - サブスクリプションの操作が現在進行中です。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。 503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

名前

型

説明

200 OK

VirtualCluster

仮想クラスターが正常に更新されました。

202 Accepted

仮想クラスターの更新が進行中です。

Other Status Codes

エラー応答: ***

400 SubscriptionNotEnabledForFeature - 機能ユーザーが使用しようとしたユーザーサブスクリプションが有効になっていません。
400 ManagementServiceFeatureDisabled - ユーザーが無効になっている機能を使用しようとしました。
400 InvalidMaintenanceWindowSettings - メンテナンス期間の設定が無効です。
400 InvalidMaintenanceWindowProperty - メンテナンス期間のプロパティが無効です。
400 InvalidMaintenanceWindowPropertyNull - 必要なプロパティが null のメンテナンス期間が無効です。
400 InvalidMaintenanceWindowTypeWithPropertySpecified - メンテナンス期間の種類に特定のプロパティを指定することはできません。
400 UpdateOfParameterNotSupported - '{0}' の更新はサポートされていません。
404 VirtualClusterDoesNotExist - 仮想クラスターが存在しません。
404 ResourceDoesNotExist - 名前 '{0}' のリソースが存在しません。続行するには、有効なリソース名を指定します。
404 VirtualClusterNotInSubscriptionResourceGroup - 指定されたリソースグループとサブスクリプションに、指定された仮想クラスターが存在しません。
404 SubscriptionNotFound - 要求されたサブスクリプションが見つかりませんでした。
404 SubscriptionDoesNotHaveVirtualCluster - 要求された仮想クラスターが見つかりませんでした
404 ResourceNotFound - 要求されたリソースが見つかりませんでした。
404 OperationIdNotFound - Id を持つ操作が存在しません。
409 VirtualClusterRemovalAlreadyInProgress - 仮想クラスターの削除は既に進行中です。仮想クラスターは、最初のインスタンスの作成で自動的に作成され、最後のインスタンスの削除と共に自動的に削除されます。詳細情報: https://aka.ms/sqlmi-virtual-cluster-removal。
409 VirtualClusterIsNotEmpty - 仮想クラスターは空ではなく、削除できません。
409 VirtualClusterIsBusy - 仮想クラスターは現在ビジー状態です。後で操作を再試行してください。
409 VirtualClusterRemovalFailed - 仮想クラスターの削除要求に失敗しました。アクティブな依存リソースがあるかどうかを確認します。
409 ConflictingVirtualClusterOperation - 仮想クラスターの操作は現在進行中です。
409 OperationCancelled - 操作がユーザーによって取り消されました。
409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。
429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。
429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。
429 ConflictingSubscriptionOperation - サブスクリプションの操作が現在進行中です。
429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。
429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。
500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。
503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。
503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

例

Update virtual cluster with tags

PATCH https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2?api-version=2021-11-01

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
  }
}


import com.azure.resourcemanager.sql.models.VirtualClusterUpdate;

/**
 * Samples for VirtualClusters Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/VirtualClusterUpdate.json
     */
    /**
     * Sample code: Update virtual cluster with tags.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateVirtualClusterWithTags(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getVirtualClusters().update("testrg",
            "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
            new VirtualClusterUpdate().withMaintenanceConfigurationId(
                "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"),
            com.azure.core.util.Context.NONE);
    }
}

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

応答のサンプル

状態コード:: 200

{
  "properties": {
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "childResources": [
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance1",
      "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance2"
    ],
    "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
  },
  "location": "onebox",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "name": "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "type": "Microsoft.Sql/virtualClusters"
}

状態コード:: 202

定義

名前	説明
VirtualCluster	Azure SQL仮想クラスター。
VirtualClusterUpdate	Azure SQL Database 仮想クラスターの更新要求。

VirtualCluster

Azure SQL仮想クラスター。

名前	型	説明
id	string	リソースの ID
location	string	リソースの場所。
name	string	リソース名。
properties.childResources	string[]	この仮想クラスター内のリソースの一覧。
properties.family	string	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。
properties.maintenanceConfigurationId	string	この仮想クラスターに適用するメンテナンス構成 ID を指定します。
properties.subnetId	string	仮想クラスターのサブネットリソース ID。
tags	object	リソースタグ。
type	string	リソースの種類。

VirtualClusterUpdate

Azure SQL Database 仮想クラスターの更新要求。

名前	型	説明
properties.childResources	string[]	この仮想クラスター内のリソースの一覧。
properties.family	string	同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。
properties.maintenanceConfigurationId	string	この仮想クラスターに適用するメンテナンス構成 ID を指定します。
properties.subnetId	string	仮想クラスターのサブネットリソース ID。
tags	object	リソースタグ。

次の方法で共有

Virtual Clusters - Update

URI パラメーター

要求本文

応答

例

Update virtual cluster with tags

要求のサンプル

応答のサンプル

定義

VirtualCluster

VirtualClusterUpdate

その他のリソース