Private Endpoint Connections - Create Or Update
特定の名前でプライベート エンドポイント接続を承認または拒否します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2024-11-15
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
account
|
path | True |
string |
Cosmos DB データベース アカウント名。 正規表現パターン: |
private
|
path | True |
string |
プライベート エンドポイント接続の名前。 |
resource
|
path | True |
string |
リソース グループの名前。 名前では大文字と小文字が区別されません。 |
subscription
|
path | True |
string |
ターゲット サブスクリプションの ID。 |
api-version
|
query | True |
string |
この操作に使用する API バージョン。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
properties.groupId |
string |
プライベート エンドポイントのグループ ID。 |
properties.privateEndpoint |
接続が属するプライベート エンドポイント。 |
|
properties.privateLinkServiceConnectionState |
プライベート エンドポイント接続の接続状態。 |
|
properties.provisioningState |
string |
プライベート エンドポイントのプロビジョニング状態。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
プライベート エンドポイント接続が正常に承認または拒否されました。 |
|
202 Accepted |
受け入れ られる。 プライベート エンドポイント接続の更新は非同期的に完了します。 |
|
Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
例
Approve or reject a private endpoint connection with a given name.
要求のサンプル
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/privateEndpointConnections/privateEndpointConnectionName?api-version=2024-11-15
{
"properties": {
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Approved by johndoe@contoso.com"
}
}
}
応答のサンプル
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg1/providers/Microsoft.DocumentDb/databaseAccounts/ddb1/privateEndpointConnections/privateEndpointConnectionName",
"name": "privateEndpointConnectionName",
"type": "Microsoft.DocumentDb/databaseAccounts/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg1Network/providers/Microsoft.Network/privateEndpoints/privateEndpointName"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Auto-approved",
"actionsRequired": "None"
},
"groupId": "Sql",
"provisioningState": "Succeeded"
}
}
定義
名前 | 説明 |
---|---|
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Private |
プライベート エンドポイント接続 |
Private |
接続が属するプライベート エンドポイント。 |
Private |
プライベート エンドポイント接続の接続状態。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
エラー オブジェクト。 |
PrivateEndpointConnection
プライベート エンドポイント接続
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
リソースの名前 |
properties.groupId |
string |
プライベート エンドポイントのグループ ID。 |
properties.privateEndpoint |
接続が属するプライベート エンドポイント。 |
|
properties.privateLinkServiceConnectionState |
プライベート エンドポイント接続の接続状態。 |
|
properties.provisioningState |
string |
プライベート エンドポイントのプロビジョニング状態。 |
type |
string |
リソースの種類。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
PrivateEndpointProperty
接続が属するプライベート エンドポイント。
名前 | 型 | 説明 |
---|---|---|
id |
string |
プライベート エンドポイントのリソース ID。 |
PrivateLinkServiceConnectionStateProperty
プライベート エンドポイント接続の接続状態。
名前 | 型 | 説明 |
---|---|---|
actionsRequired |
string |
基本的なワークフローを超えて必要なアクション (承認/拒否/切断) |
description |
string |
プライベート リンク サービスの接続の説明。 |
status |
string |
プライベート リンク サービスの接続状態。 |