Database Accounts - Update

リファレンス

サービス:: Cosmos DB Resource Provider

API バージョン:: 2024-11-15

既存の Azure Cosmos DB データベースアカウントのプロパティを更新します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}?api-version=2024-11-15

URI パラメーター

名前	/	必須	型	説明
accountName	path	True	string	Cosmos DB データベースアカウント名。正規表現パターン: `^[a-z0-9]+(-[a-z0-9]+)*`
resourceGroupName	path	True	string	リソースグループの名前。名前では大文字と小文字が区別されません。
subscriptionId	path	True	string	ターゲットサブスクリプションの ID。
api-version	query	True	string	この操作に使用する API バージョン。

要求本文

名前	型	説明
identity	ManagedServiceIdentity	リソースの ID。
location	string	リソースが属するリソースグループの場所。
properties.analyticalStorageConfiguration	AnalyticalStorageConfiguration	分析ストレージ固有のプロパティ。
properties.apiProperties	ApiProperties	API 固有のプロパティ。現在、MongoDB API でのみサポートされています。
properties.backupPolicy	BackupPolicy: PeriodicModeBackupPolicy ContinuousModeBackupPolicy	アカウントでバックアップを作成するためのポリシーを表すオブジェクト。
properties.capabilities	Capability[]	アカウントの Cosmos DB 機能の一覧
properties.capacity	Capacity	アカウントの容量の適用に関連するすべてのプロパティを表すオブジェクト。
properties.connectorOffer	ConnectorOffer	Cosmos DB データベース C* アカウントの cassandra コネクタオファーの種類。
properties.consistencyPolicy	ConsistencyPolicy	Cosmos DB アカウントの整合性ポリシー。
properties.cors	CorsPolicy[]	Cosmos DB データベースアカウントの CORS ポリシー。
properties.customerManagedKeyStatus	string	アカウントのカスタマーマネージドキー機能の状態を示します。エラーが発生した場合、このプロパティはトラブルシューティングのガイダンスを提供します。
properties.defaultIdentity	string	カスタマーマネージドキーなどの機能で使用されるキーコンテナーにアクセスするための既定の ID。既定の ID は、ユーザーが明示的に設定する必要があります。 "FirstPartyIdentity"、"SystemAssignedIdentity" などを指定できます。
properties.disableKeyBasedMetadataWriteAccess	boolean	アカウントキーを使用してメタデータリソース (データベース、コンテナー、スループット) に対する書き込み操作を無効にする
properties.disableLocalAuth	boolean	ローカル認証をオプトアウトし、MSI と AAD のみを認証専用に使用できるようにします。
properties.enableAnalyticalStorage	boolean	ストレージ分析を有効にするかどうかを示すフラグ。
properties.enableAutomaticFailover	boolean	障害が原因でリージョンが使用できないまれな場合に、書き込みリージョンの自動フェールオーバーを有効にします。自動フェールオーバーでは、アカウントの新しい書き込みリージョンが作成され、アカウント用に構成されたフェールオーバーの優先順位に基づいて選択されます。
properties.enableBurstCapacity	boolean	アカウントのバースト容量機能の有効化/無効化を示すフラグ
properties.enableCassandraConnector	boolean	Cosmos DB C* アカウントで cassandra コネクタを有効にします
properties.enableFreeTier	boolean	Free レベルが有効かどうかを示すフラグ。
properties.enableMultipleWriteLocations	boolean	アカウントを複数の場所に書き込める
properties.enablePartitionMerge	boolean	アカウントでのパーティションマージ機能の有効化/無効化を示すフラグ
properties.enablePerRegionPerPartitionAutoscale	boolean	アカウントでの PerRegionPerPartitionAutoscale 機能の有効化/無効化を示すフラグ
properties.ipRules	IpAddressOrRange[]	IpRules の一覧。
properties.isVirtualNetworkFilterEnabled	boolean	仮想ネットワーク ACL 規則を有効または無効にするかどうかを示すフラグ。
properties.keyVaultKeyUri	string	キーコンテナーの URI
properties.locations	Location[]	Cosmos DB アカウントで有効になっている georeplication の場所を含む配列。
properties.minimalTlsVersion	MinimalTlsVersion	許可される Tls の最小バージョンを示します。既定値は Tls 1.2 です。 Cassandra API と Mongo API は Tls 1.2 でのみ機能します。
properties.networkAclBypass	NetworkAclBypass	ファイアウォールチェックをバイパスできるサービスを示します。
properties.networkAclBypassResourceIds	string[]	Cosmos DB アカウントのネットワーク ACL バイパスのリソース ID を含む配列。
properties.publicNetworkAccess	PublicNetworkAccess	パブリックネットワークからの要求が許可されるかどうか
properties.virtualNetworkRules	VirtualNetworkRule[]	Cosmos DB アカウント用に構成された仮想ネットワーク ACL 規則の一覧。
tags	object	タグは、リソースを記述するキーと値のペアの一覧です。これらのタグは、(リソースグループ間で) このリソースを表示およびグループ化する場合に使用できます。リソースには最大 15 個のタグを指定できます。各タグには、128 文字以下のキーと 256 文字以下の値が必要です。たとえば、テンプレートの種類の既定のエクスペリエンスは"defaultExperience": "Cassandra" で設定されます。現在の "defaultExperience" 値には、"Table"、"Graph"、"DocumentDB"、"MongoDB" も含まれます。

応答

名前	型	説明
200 OK	DatabaseAccountGetResults	データベースアカウントの更新操作は非同期的に完了します。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

CosmosDBDatabaseAccountPatch

要求のサンプル

HTTP

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1?api-version=2024-11-15

{
  "location": "westus",
  "tags": {
    "dept": "finance"
  },
  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
    }
  },
  "properties": {
    "ipRules": [
      {
        "ipAddressOrRange": "23.43.230.120"
      },
      {
        "ipAddressOrRange": "110.12.240.0/12"
      }
    ],
    "isVirtualNetworkFilterEnabled": true,
    "virtualNetworkRules": [
      {
        "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "ignoreMissingVNetServiceEndpoint": false
      }
    ],
    "consistencyPolicy": {
      "defaultConsistencyLevel": "BoundedStaleness",
      "maxIntervalInSeconds": 10,
      "maxStalenessPrefix": 200
    },
    "defaultIdentity": "FirstPartyIdentity",
    "enableFreeTier": false,
    "enableAnalyticalStorage": true,
    "enableBurstCapacity": true,
    "enablePerRegionPerPartitionAutoscale": true,
    "analyticalStorageConfiguration": {
      "schemaType": "WellDefined"
    },
    "backupPolicy": {
      "type": "Periodic",
      "periodicModeProperties": {
        "backupIntervalInMinutes": 240,
        "backupRetentionIntervalInHours": 720,
        "backupStorageRedundancy": "Local"
      }
    },
    "networkAclBypass": "AzureServices",
    "networkAclBypassResourceIds": [
      "/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"
    ],
    "capacity": {
      "totalThroughputLimit": 2000
    },
    "enablePartitionMerge": true,
    "minimalTlsVersion": "Tls"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
  "name": "ddb1",
  "location": "West US",
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "kind": "GlobalDocumentDB",
  "tags": {
    "dept": "finance"
  },
  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "principalId": "52f4fef3-3c3f-4ff3-b52e-b5c9eeb68656",
    "tenantId": "33e01921-4d64-4f8c-a055-5bdaffd5e33d",
    "userAssignedIdentities": {
      "/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
        "clientId": "fbe75b66-01c5-4f87-a220-233af3270436",
        "principalId": "33e01921-4d64-4f8c-a055-5bdaffd5e33d"
      }
    }
  },
  "properties": {
    "provisioningState": "Succeeded",
    "documentEndpoint": "https://ddb1.documents.azure.com:443/",
    "databaseAccountOfferType": "Standard",
    "ipRules": [
      {
        "ipAddressOrRange": "23.43.230.120"
      },
      {
        "ipAddressOrRange": "110.12.240.0/12"
      }
    ],
    "isVirtualNetworkFilterEnabled": true,
    "disableKeyBasedMetadataWriteAccess": false,
    "consistencyPolicy": {
      "defaultConsistencyLevel": "BoundedStaleness",
      "maxIntervalInSeconds": 10,
      "maxStalenessPrefix": 200
    },
    "writeLocations": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
        "provisioningState": "Succeeded",
        "failoverPriority": 0
      }
    ],
    "readLocations": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
        "provisioningState": "Succeeded",
        "failoverPriority": 0
      }
    ],
    "locations": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
        "provisioningState": "Succeeded",
        "failoverPriority": 0
      }
    ],
    "failoverPolicies": [
      {
        "id": "ddb1-eastus",
        "locationName": "East US",
        "failoverPriority": 0
      }
    ],
    "virtualNetworkRules": [
      {
        "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "ignoreMissingVNetServiceEndpoint": false
      }
    ],
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/account1/privateEndpointConnections/pe1",
        "properties": {
          "privateEndpoint": {
            "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/privateEndpoints/pe1"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "actionsRequired": "None"
          }
        }
      }
    ],
    "cors": [],
    "defaultIdentity": "FirstPartyIdentity",
    "enableFreeTier": false,
    "apiProperties": {},
    "enableAnalyticalStorage": true,
    "enableBurstCapacity": true,
    "analyticalStorageConfiguration": {
      "schemaType": "WellDefined"
    },
    "backupPolicy": {
      "type": "Periodic",
      "periodicModeProperties": {
        "backupIntervalInMinutes": 240,
        "backupRetentionIntervalInHours": 720,
        "backupStorageRedundancy": "Local"
      }
    },
    "networkAclBypass": "AzureServices",
    "networkAclBypassResourceIds": [
      "/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"
    ],
    "capacity": {
      "totalThroughputLimit": 2000
    },
    "keysMetadata": {
      "primaryMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      },
      "secondaryMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      },
      "primaryReadonlyMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      },
      "secondaryReadonlyMasterKey": {
        "generationTime": "2022-02-25T20:30:11Z"
      }
    },
    "enablePartitionMerge": true,
    "minimalTlsVersion": "Tls"
  }
}

定義

名前	説明
AccountKeyMetadata	特定のデータベースアカウントのアクセスキーに関連するメタデータ。
AnalyticalStorageConfiguration	分析ストレージ固有のプロパティ。
AnalyticalStorageSchemaType	分析ストレージのスキーマの種類について説明します。
ApiProperties
BackupPolicyMigrationState	バックアップポリシー間の移行の状態を表すオブジェクト。
BackupPolicyMigrationStatus	バックアップポリシーの種類間の移行の状態について説明します。
BackupPolicyType	バックアップのモードについて説明します。
BackupStorageRedundancy	バックアップストレージの冗長性の種類を示す列挙型。
Capability	Cosmos DB 機能オブジェクト
Capacity	アカウントの容量の適用に関連するすべてのプロパティを表すオブジェクト。
ConnectorOffer	Cosmos DB C* データベースアカウントの cassandra コネクタオファーの種類。
ConsistencyPolicy	Cosmos DB データベースアカウントの整合性ポリシー。
ContinuousModeBackupPolicy	連続モードのバックアップポリシーを表すオブジェクト。
ContinuousModeProperties	定期モードバックアップの構成値
ContinuousTier	継続的バックアップ層の種類を示す列挙型。
CorsPolicy	Cosmos DB データベースアカウントの CORS ポリシー。
createdByType	リソースを作成した ID の種類。
CreateMode	アカウント作成モードを示す列挙型。
DatabaseAccountGetResults	Azure Cosmos DB データベースアカウント。
DatabaseAccountKeysMetadata	指定された Cosmos DB データベースアカウントの各アクセスキーに関連するメタデータ。
DatabaseAccountKind	データベースアカウントの種類を示します。これは、データベースアカウントの作成時にのみ設定できます。
DatabaseAccountOfferType	Cosmos DB データベースアカウントのオファーの種類。
DatabaseAccountUpdateParameters	Azure Cosmos DB データベースアカウントのプロパティに修正プログラムを適用するためのパラメーター。
DatabaseRestoreResource	復元する特定のデータベース。
DefaultConsistencyLevel	Cosmos DB アカウントの既定の整合性レベルと構成設定。
FailoverPolicy	データベースアカウントの特定のリージョンのフェールオーバーポリシー。
GremlinDatabaseRestoreResource	復元する特定の Gremlin データベース。
IpAddressOrRange	IpAddressOrRange オブジェクト
Location	Azure Cosmos DB データベースアカウントがデプロイされているリージョン。
ManagedServiceIdentity	リソースの ID。
MinimalTlsVersion	許可される Tls の最小バージョンを示します。既定値は Tls 1.2 です。 Cassandra API と Mongo API は Tls 1.2 でのみ機能します。
NetworkAclBypass	ファイアウォールチェックをバイパスできるサービスを示します。
PeriodicModeBackupPolicy	定期的なモードのバックアップポリシーを表すオブジェクト。
PeriodicModeProperties	定期モードバックアップの構成値
PrivateEndpointConnection	プライベートエンドポイント接続
PrivateEndpointProperty	接続が属するプライベートエンドポイント。
PrivateLinkServiceConnectionStateProperty	プライベートエンドポイント接続の接続状態。
PublicNetworkAccess	パブリックネットワークからの要求が許可されるかどうか
ResourceIdentityType	リソースに使用される ID の種類。型 'SystemAssigned,UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。型 'None' は、サービスからすべての ID を削除します。
RestoreMode	復元のモードについて説明します。
RestoreParameters	復元に関する情報を示すパラメーター。
ServerVersion	MongoDB アカウントのバージョンについて説明します。
systemData	リソースの作成と最後の変更に関連するメタデータ。
UserAssignedIdentities	リソースに関連付けられているユーザー ID の一覧。ユーザー ID ディクショナリのキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。
VirtualNetworkRule	Virtual Network ACL Rule オブジェクト

AccountKeyMetadata

特定のデータベースアカウントのアクセスキーに関連するメタデータ。

名前	型	説明
generationTime	string	ISO-8601 形式のキーの UTC での生成時刻。オブジェクトに値がない場合は、2022-06-18 より前に最後のキーの再生成がトリガーされたことを意味します。

AnalyticalStorageConfiguration

分析ストレージ固有のプロパティ。

名前	型	説明
schemaType	AnalyticalStorageSchemaType	分析ストレージのスキーマの種類について説明します。

AnalyticalStorageSchemaType

分析ストレージのスキーマの種類について説明します。

名前	型	説明
FullFidelity	string
WellDefined	string

ApiProperties

名前	型	説明
serverVersion	ServerVersion	MongoDB アカウントのバージョンについて説明します。

BackupPolicyMigrationState

バックアップポリシー間の移行の状態を表すオブジェクト。

名前	型	説明
startTime	string	バックアップポリシーの移行が開始された時刻 (ISO-8601 形式)。
status	BackupPolicyMigrationStatus	バックアップポリシーの種類間の移行の状態について説明します。
targetType	BackupPolicyType	バックアップポリシー移行のターゲットバックアップポリシーの種類について説明します。

BackupPolicyMigrationStatus

バックアップポリシーの種類間の移行の状態について説明します。

名前	型	説明
Completed	string
Failed	string
InProgress	string
Invalid	string

BackupPolicyType

バックアップのモードについて説明します。

名前	型	説明
Continuous	string
Periodic	string

BackupStorageRedundancy

バックアップストレージの冗長性の種類を示す列挙型。

名前	型	説明
Geo	string
Local	string
Zone	string

Capability

Cosmos DB 機能オブジェクト

名前	型	説明
name	string	Cosmos DB 機能の名前。たとえば、"name": "EnableCassandra" です。現在の値には、"EnableTable" と "EnableGremlin" も含まれます。

Capacity

アカウントの容量の適用に関連するすべてのプロパティを表すオブジェクト。

名前	型	説明
totalThroughputLimit	integer	アカウントに課される合計スループット制限。 totalThroughputLimit が 2000 の場合、そのアカウントでプロビジョニングできる最大スループットの厳密な制限は 2000 になります。 totalThroughputLimit の -1 は、スループットのプロビジョニングに制限がないことを示します。

ConnectorOffer

Cosmos DB C* データベースアカウントの cassandra コネクタオファーの種類。

名前	型	説明
Small	string

ConsistencyPolicy

Cosmos DB データベースアカウントの整合性ポリシー。

名前	型	説明
defaultConsistencyLevel	DefaultConsistencyLevel	Cosmos DB アカウントの既定の整合性レベルと構成設定。
maxIntervalInSeconds	integer	有界整合性制約の整合性レベルで使用する場合、この値は許容される制約の時間量 (秒単位) を表します。この値に使用できる範囲は 5 ~ 86400 です。 defaultConsistencyPolicy が 'BoundedStaleness' に設定されている場合に必要です。
maxStalenessPrefix	integer	有界整合性制約の整合性レベルで使用する場合、この値は許容される古い要求の数を表します。この値に使用できる範囲は 1 ~ 2,147,483,647 です。 defaultConsistencyPolicy が 'BoundedStaleness' に設定されている場合に必要です。

ContinuousModeBackupPolicy

連続モードのバックアップポリシーを表すオブジェクト。

名前	型	説明
continuousModeProperties	ContinuousModeProperties	連続モードバックアップの構成値
migrationState	BackupPolicyMigrationState	バックアップポリシー間の移行の状態を表すオブジェクト。
type	string: Continuous	バックアップのモードについて説明します。

ContinuousModeProperties

定期モードバックアップの構成値

名前	型	説明
tier	ContinuousTier	連続バックアップモードの種類を示す列挙型

ContinuousTier

継続的バックアップ層の種類を示す列挙型。

名前	型	説明
Continuous30Days	string
Continuous7Days	string

CorsPolicy

Cosmos DB データベースアカウントの CORS ポリシー。

名前	型	説明
allowedHeaders	string	配信元ドメインが CORS 要求で指定できる要求ヘッダー。
allowedMethods	string	配信元ドメインが CORS 要求に使用できるメソッド (HTTP 要求動詞)。
allowedOrigins	string	CORS 経由でサービスに対して要求を行うことができます。
exposedHeaders	string	CORS 要求への応答で送信され、ブラウザーによって要求発行者に公開される可能性がある応答ヘッダー。
maxAgeInSeconds	integer	ブラウザーがプレフライト OPTIONS 要求をキャッシュする最大時間。

createdByType

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

CreateMode

アカウント作成モードを示す列挙型。

名前	型	説明
Default	string
Restore	string

DatabaseAccountGetResults

Azure Cosmos DB データベースアカウント。

名前	型	規定値	説明
id	string		ARM リソースの一意のリソース識別子。
identity	ManagedServiceIdentity		リソースの ID。
kind	DatabaseAccountKind	GlobalDocumentDB	データベースアカウントの種類を示します。これは、データベースアカウントの作成時にのみ設定できます。
location	string		リソースが属するリソースグループの場所。
name	string		ARM リソースの名前。
properties.analyticalStorageConfiguration	AnalyticalStorageConfiguration		分析ストレージ固有のプロパティ。
properties.apiProperties	ApiProperties		API 固有のプロパティ。
properties.backupPolicy	BackupPolicy: ContinuousModeBackupPolicy PeriodicModeBackupPolicy		アカウントでバックアップを作成するためのポリシーを表すオブジェクト。
properties.capabilities	Capability[]		アカウントの Cosmos DB 機能の一覧
properties.capacity	Capacity		アカウントの容量の適用に関連するすべてのプロパティを表すオブジェクト。
properties.connectorOffer	ConnectorOffer		Cosmos DB データベース C* アカウントの cassandra コネクタオファーの種類。
properties.consistencyPolicy	ConsistencyPolicy		Cosmos DB データベースアカウントの整合性ポリシー。
properties.cors	CorsPolicy[]		Cosmos DB データベースアカウントの CORS ポリシー。
properties.createMode	CreateMode	Default	アカウント作成モードを示す列挙型。
properties.customerManagedKeyStatus	string		アカウントのカスタマーマネージドキー機能の状態を示します。エラーが発生した場合、このプロパティはトラブルシューティングのガイダンスを提供します。
properties.databaseAccountOfferType	DatabaseAccountOfferType		Cosmos DB データベースアカウントのオファーの種類。既定値: Standard。
properties.defaultIdentity	string		カスタマーマネージドキーなどの機能で使用されるキーコンテナーにアクセスするための既定の ID。既定の ID は、ユーザーが明示的に設定する必要があります。 "FirstPartyIdentity"、"SystemAssignedIdentity" などを指定できます。
properties.disableKeyBasedMetadataWriteAccess	boolean		アカウントキーを使用してメタデータリソース (データベース、コンテナー、スループット) に対する書き込み操作を無効にする
properties.disableLocalAuth	boolean		ローカル認証をオプトアウトし、MSI と AAD のみを認証専用に使用できるようにします。
properties.documentEndpoint	string		Cosmos DB データベースアカウントの接続エンドポイント。
properties.enableAnalyticalStorage	boolean		ストレージ分析を有効にするかどうかを示すフラグ。
properties.enableAutomaticFailover	boolean		障害が原因でリージョンが使用できないまれな場合に、書き込みリージョンの自動フェールオーバーを有効にします。自動フェールオーバーでは、アカウントの新しい書き込みリージョンが作成され、アカウント用に構成されたフェールオーバーの優先順位に基づいて選択されます。
properties.enableBurstCapacity	boolean		アカウントのバースト容量機能の有効化/無効化を示すフラグ
properties.enableCassandraConnector	boolean		Cosmos DB C* アカウントで cassandra コネクタを有効にします
properties.enableFreeTier	boolean		Free レベルが有効かどうかを示すフラグ。
properties.enableMultipleWriteLocations	boolean		アカウントを複数の場所に書き込める
properties.enablePartitionMerge	boolean		アカウントでのパーティションマージ機能の有効化/無効化を示すフラグ
properties.enablePerRegionPerPartitionAutoscale	boolean		アカウントでの PerRegionPerPartitionAutoscale 機能の有効化/無効化を示すフラグ
properties.failoverPolicies	FailoverPolicy[]		フェールオーバーの優先順位で並べ替えられたリージョンを含む配列。
properties.instanceId	string		データベースアカウントに割り当てられた一意の識別子
properties.ipRules	IpAddressOrRange[]		IpRules の一覧。
properties.isVirtualNetworkFilterEnabled	boolean		仮想ネットワーク ACL 規則を有効または無効にするかどうかを示すフラグ。
properties.keyVaultKeyUri	string		キーコンテナーの URI
properties.keysMetadata	DatabaseAccountKeysMetadata		Cosmos DB アカウントのアカウントキーのメタデータを表すオブジェクト。
properties.locations	Location[]		Cosmos DB アカウントで有効になっているすべての場所を含む配列。
properties.minimalTlsVersion	MinimalTlsVersion		許可される Tls の最小バージョンを示します。既定値は Tls 1.2 です。 Cassandra API と Mongo API は Tls 1.2 でのみ機能します。
properties.networkAclBypass	NetworkAclBypass		ファイアウォールチェックをバイパスできるサービスを示します。
properties.networkAclBypassResourceIds	string[]		Cosmos DB アカウントのネットワーク ACL バイパスのリソース ID を含む配列。
properties.privateEndpointConnections	PrivateEndpointConnection[]		Cosmos DB アカウント用に構成されたプライベートエンドポイント接続の一覧。
properties.provisioningState	string		操作が呼び出されたときの Cosmos DB アカウントの状態。状態は次のいずれかになります。 "作成中" – Cosmos DB アカウントが作成されています。アカウントが作成中の状態の場合、Cosmos DB アカウントの作成操作の入力として指定されたプロパティのみが返されます。 "成功" – Cosmos DB アカウントがアクティブに使用されています。 '更新中' – Cosmos DB アカウントが更新中です。 "削除中" – Cosmos DB アカウントが削除されています。 'Failed' – Cosmos DB アカウントの作成に失敗しました。 'DeletionFailed' – Cosmos DB アカウントの削除に失敗しました。
properties.publicNetworkAccess	PublicNetworkAccess		パブリックネットワークからの要求が許可されるかどうか
properties.readLocations	Location[]		Cosmos DB アカウントで有効になっている読み取り場所を含む配列。
properties.restoreParameters	RestoreParameters		復元に関する情報を示すパラメーター。
properties.virtualNetworkRules	VirtualNetworkRule[]		Cosmos DB アカウント用に構成された仮想ネットワーク ACL 規則の一覧。
properties.writeLocations	Location[]		Cosmos DB アカウントの書き込み場所を含む配列。
systemData	systemData		このリソースに関連するシステムメタデータ。
tags	object		タグは、リソースを記述するキーと値のペアの一覧です。これらのタグは、(リソースグループ間で) このリソースを表示およびグループ化する場合に使用できます。リソースには最大 15 個のタグを指定できます。各タグには、128 文字以下のキーと 256 文字以下の値が必要です。たとえば、テンプレートの種類の既定のエクスペリエンスは"defaultExperience": "Cassandra" で設定されます。現在の "defaultExperience" 値には、"Table"、"Graph"、"DocumentDB"、"MongoDB" も含まれます。
type	string		Azure リソースの種類。

DatabaseAccountKeysMetadata

指定された Cosmos DB データベースアカウントの各アクセスキーに関連するメタデータ。

名前	型	説明
primaryMasterKey	AccountKeyMetadata	指定された Cosmos DB データベースアカウントのプライマリ Read-Write キーに関連するメタデータ。
primaryReadonlyMasterKey	AccountKeyMetadata	指定された Cosmos DB データベースアカウントのプライマリ Read-Only キーに関連するメタデータ。
secondaryMasterKey	AccountKeyMetadata	指定された Cosmos DB データベースアカウントのセカンダリ Read-Write キーに関連するメタデータ。
secondaryReadonlyMasterKey	AccountKeyMetadata	指定された Cosmos DB データベースアカウントのセカンダリ Read-Only キーに関連するメタデータ。

DatabaseAccountKind

データベースアカウントの種類を示します。これは、データベースアカウントの作成時にのみ設定できます。

名前	型	説明
GlobalDocumentDB	string
MongoDB	string
Parse	string

DatabaseAccountOfferType

Cosmos DB データベースアカウントのオファーの種類。

名前	型	説明
Standard	string

DatabaseAccountUpdateParameters

Azure Cosmos DB データベースアカウントのプロパティに修正プログラムを適用するためのパラメーター。

名前	型	説明
identity	ManagedServiceIdentity	リソースの ID。
location	string	リソースが属するリソースグループの場所。
properties.analyticalStorageConfiguration	AnalyticalStorageConfiguration	分析ストレージ固有のプロパティ。
properties.apiProperties	ApiProperties	API 固有のプロパティ。現在、MongoDB API でのみサポートされています。
properties.backupPolicy	BackupPolicy: ContinuousModeBackupPolicy PeriodicModeBackupPolicy	アカウントでバックアップを作成するためのポリシーを表すオブジェクト。
properties.capabilities	Capability[]	アカウントの Cosmos DB 機能の一覧
properties.capacity	Capacity	アカウントの容量の適用に関連するすべてのプロパティを表すオブジェクト。
properties.connectorOffer	ConnectorOffer	Cosmos DB データベース C* アカウントの cassandra コネクタオファーの種類。
properties.consistencyPolicy	ConsistencyPolicy	Cosmos DB アカウントの整合性ポリシー。
properties.cors	CorsPolicy[]	Cosmos DB データベースアカウントの CORS ポリシー。
properties.customerManagedKeyStatus	string	アカウントのカスタマーマネージドキー機能の状態を示します。エラーが発生した場合、このプロパティはトラブルシューティングのガイダンスを提供します。
properties.defaultIdentity	string	カスタマーマネージドキーなどの機能で使用されるキーコンテナーにアクセスするための既定の ID。既定の ID は、ユーザーが明示的に設定する必要があります。 "FirstPartyIdentity"、"SystemAssignedIdentity" などを指定できます。
properties.disableKeyBasedMetadataWriteAccess	boolean	アカウントキーを使用してメタデータリソース (データベース、コンテナー、スループット) に対する書き込み操作を無効にする
properties.disableLocalAuth	boolean	ローカル認証をオプトアウトし、MSI と AAD のみを認証専用に使用できるようにします。
properties.enableAnalyticalStorage	boolean	ストレージ分析を有効にするかどうかを示すフラグ。
properties.enableAutomaticFailover	boolean	障害が原因でリージョンが使用できないまれな場合に、書き込みリージョンの自動フェールオーバーを有効にします。自動フェールオーバーでは、アカウントの新しい書き込みリージョンが作成され、アカウント用に構成されたフェールオーバーの優先順位に基づいて選択されます。
properties.enableBurstCapacity	boolean	アカウントのバースト容量機能の有効化/無効化を示すフラグ
properties.enableCassandraConnector	boolean	Cosmos DB C* アカウントで cassandra コネクタを有効にします
properties.enableFreeTier	boolean	Free レベルが有効かどうかを示すフラグ。
properties.enableMultipleWriteLocations	boolean	アカウントを複数の場所に書き込める
properties.enablePartitionMerge	boolean	アカウントでのパーティションマージ機能の有効化/無効化を示すフラグ
properties.enablePerRegionPerPartitionAutoscale	boolean	アカウントでの PerRegionPerPartitionAutoscale 機能の有効化/無効化を示すフラグ
properties.ipRules	IpAddressOrRange[]	IpRules の一覧。
properties.isVirtualNetworkFilterEnabled	boolean	仮想ネットワーク ACL 規則を有効または無効にするかどうかを示すフラグ。
properties.keyVaultKeyUri	string	キーコンテナーの URI
properties.keysMetadata	DatabaseAccountKeysMetadata	メタデータは読み取り専用であるため、更新操作中は、このプロパティは無視されます。オブジェクトは、Cosmos DB アカウントのアカウントキーのメタデータを表します。
properties.locations	Location[]	Cosmos DB アカウントで有効になっている georeplication の場所を含む配列。
properties.minimalTlsVersion	MinimalTlsVersion	許可される Tls の最小バージョンを示します。既定値は Tls 1.2 です。 Cassandra API と Mongo API は Tls 1.2 でのみ機能します。
properties.networkAclBypass	NetworkAclBypass	ファイアウォールチェックをバイパスできるサービスを示します。
properties.networkAclBypassResourceIds	string[]	Cosmos DB アカウントのネットワーク ACL バイパスのリソース ID を含む配列。
properties.publicNetworkAccess	PublicNetworkAccess	パブリックネットワークからの要求が許可されるかどうか
properties.virtualNetworkRules	VirtualNetworkRule[]	Cosmos DB アカウント用に構成された仮想ネットワーク ACL 規則の一覧。
tags	object	タグは、リソースを記述するキーと値のペアの一覧です。これらのタグは、(リソースグループ間で) このリソースを表示およびグループ化する場合に使用できます。リソースには最大 15 個のタグを指定できます。各タグには、128 文字以下のキーと 256 文字以下の値が必要です。たとえば、テンプレートの種類の既定のエクスペリエンスは"defaultExperience": "Cassandra" で設定されます。現在の "defaultExperience" 値には、"Table"、"Graph"、"DocumentDB"、"MongoDB" も含まれます。

DatabaseRestoreResource

復元する特定のデータベース。

名前	型	説明
collectionNames	string[]	復元に使用できるコレクションの名前。
databaseName	string	復元に使用できるデータベースの名前。

DefaultConsistencyLevel

Cosmos DB アカウントの既定の整合性レベルと構成設定。

名前	型	説明
BoundedStaleness	string
ConsistentPrefix	string
Eventual	string
Session	string
Strong	string

FailoverPolicy

データベースアカウントの特定のリージョンのフェールオーバーポリシー。

名前	型	説明
failoverPriority	integer	リージョンのフェールオーバーの優先順位。フェールオーバーの優先度が 0 の場合は、書き込みリージョンを示します。フェールオーバー優先度の最大値 = (リージョンの合計数 - 1)。フェールオーバー優先度の値は、データベースアカウントが存在するリージョンごとに一意である必要があります。
id	string	データベースアカウントがレプリケートされるリージョンの一意識別子。例: <accountName>-<locationName>。
locationName	string	データベースアカウントが存在するリージョンの名前。

GremlinDatabaseRestoreResource

復元する特定の Gremlin データベース。

名前	型	説明
databaseName	string	復元に使用できる gremlin データベースの名前。
graphNames	string[]	復元に使用できるグラフの名前。

IpAddressOrRange

IpAddressOrRange オブジェクト

名前	型	説明
ipAddressOrRange	string	1 つの IPv4 アドレスまたは CIDR 形式の単一の IPv4 アドレス範囲。 IP アドレスは適切な形式である必要があり、10.0.0.0/8、100.64.0.0/10、172.16.0.0/12、192.168.0.0/16 のいずれかの範囲に含めることはできません。IP アドレスフィルターでは適用できないためです。有効な入力の例: "23.40.210.245" または "23.40.210.0/8"。

Location

Azure Cosmos DB データベースアカウントがデプロイされているリージョン。

名前	型	説明
documentEndpoint	string	特定のリージョンの接続エンドポイント。例: https://<accountName>-<locationName>.documents.azure.com:443/
failoverPriority	integer	リージョンのフェールオーバーの優先順位。フェールオーバーの優先度が 0 の場合は、書き込みリージョンを示します。フェールオーバー優先度の最大値 = (リージョンの合計数 - 1)。フェールオーバー優先度の値は、データベースアカウントが存在するリージョンごとに一意である必要があります。
id	string	データベースアカウント内のリージョンの一意識別子。例: <accountName>-<locationName>。
isZoneRedundant	boolean	このリージョンが AvailabilityZone リージョンかどうかを示すフラグ
locationName	string	リージョンの名前。
provisioningState	string	操作が呼び出されたときの Cosmos DB アカウントの状態。状態は次のいずれかになります。 "作成中" – Cosmos DB アカウントが作成されています。アカウントが作成中の状態の場合、Cosmos DB アカウントの作成操作の入力として指定されたプロパティのみが返されます。 "成功" – Cosmos DB アカウントがアクティブに使用されています。 '更新中' – Cosmos DB アカウントが更新中です。 "削除中" – Cosmos DB アカウントが削除されています。 'Failed' – Cosmos DB アカウントの作成に失敗しました。 'DeletionFailed' – Cosmos DB アカウントの削除に失敗しました。

ManagedServiceIdentity

リソースの ID。

名前	型	説明
principalId	string	システム割り当て ID のプリンシパル ID。このプロパティは、システム割り当て ID にのみ提供されます。
tenantId	string	システム割り当て ID のテナント ID。このプロパティは、システム割り当て ID にのみ提供されます。
type	ResourceIdentityType	リソースに使用される ID の種類。型 'SystemAssigned,UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。型 'None' は、サービスからすべての ID を削除します。
userAssignedIdentities	UserAssignedIdentities	リソースに関連付けられているユーザー ID の一覧。ユーザー ID ディクショナリのキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。

MinimalTlsVersion

許可される Tls の最小バージョンを示します。既定値は Tls 1.2 です。 Cassandra API と Mongo API は Tls 1.2 でのみ機能します。

名前	型	説明
Tls	string
Tls11	string
Tls12	string

NetworkAclBypass

ファイアウォールチェックをバイパスできるサービスを示します。

名前	型	説明
AzureServices	string
None	string

PeriodicModeBackupPolicy

定期的なモードのバックアップポリシーを表すオブジェクト。

名前	型	説明
migrationState	BackupPolicyMigrationState	バックアップポリシー間の移行の状態を表すオブジェクト。
periodicModeProperties	PeriodicModeProperties	定期モードバックアップの構成値
type	string: Periodic	バックアップのモードについて説明します。

PeriodicModeProperties

定期モードバックアップの構成値

名前	型	説明
backupIntervalInMinutes	integer	2 つのバックアップ間の間隔を分単位で表す整数
backupRetentionIntervalInHours	integer	各バックアップが保持される時間 (時間単位) を表す整数
backupStorageRedundancy	BackupStorageRedundancy	バックアップの保存場所の種類を示す列挙型

PrivateEndpointConnection

プライベートエンドポイント接続

名前	型	説明
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties.groupId	string	プライベートエンドポイントのグループ ID。
properties.privateEndpoint	PrivateEndpointProperty	接続が属するプライベートエンドポイント。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	プライベートエンドポイント接続の接続状態。
properties.provisioningState	string	プライベートエンドポイントのプロビジョニング状態。
type	string	リソースの種類。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

接続が属するプライベートエンドポイント。

名前	型	説明
id	string	プライベートエンドポイントのリソース ID。

PrivateLinkServiceConnectionStateProperty

プライベートエンドポイント接続の接続状態。

名前	型	説明
actionsRequired	string	基本的なワークフローを超えて必要なアクション (承認/拒否/切断)
description	string	プライベートリンクサービスの接続の説明。
status	string	プライベートリンクサービスの接続状態。

PublicNetworkAccess

パブリックネットワークからの要求が許可されるかどうか

名前	型	説明
Disabled	string
Enabled	string
SecuredByPerimeter	string

ResourceIdentityType

リソースに使用される ID の種類。型 'SystemAssigned,UserAssigned' には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。型 'None' は、サービスからすべての ID を削除します。

名前	型	説明
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

RestoreMode

復元のモードについて説明します。

名前	型	説明
PointInTime	string

RestoreParameters

復元に関する情報を示すパラメーター。

名前	型	説明
databasesToRestore	DatabaseRestoreResource[]	復元に使用できる特定のデータベースの一覧。
gremlinDatabasesToRestore	GremlinDatabaseRestoreResource[]	復元に使用できる特定の gremlin データベースの一覧。
restoreMode	RestoreMode	復元のモードについて説明します。
restoreSource	string	復元を開始する必要がある復元可能なデータベースアカウントの ID。例: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}
restoreTimestampInUtc	string	アカウントを復元する必要がある時間 (ISO-8601 形式)。
restoreWithTtlDisabled	boolean	復元が成功した時点で、復元されたアカウントに Time-To-Live を無効にするかどうかを指定します。
tablesToRestore	string[]	復元に使用できる特定のテーブルの一覧。

ServerVersion

MongoDB アカウントのバージョンについて説明します。

名前	型	説明
3.2	string
3.6	string
4.0	string
4.2	string
5.0	string
6.0	string
7.0	string

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

UserAssignedIdentities

リソースに関連付けられているユーザー ID の一覧。ユーザー ID ディクショナリのキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。

名前	型	説明

VirtualNetworkRule

Virtual Network ACL Rule オブジェクト

名前	型	説明
id	string	サブネットのリソース ID (例: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName})。
ignoreMissingVNetServiceEndpoint	boolean	仮想ネットワークで vnet サービスエンドポイントが有効になる前に、ファイアウォール規則を作成します。

次の方法で共有