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 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
account
|
path | True |
string |
Cosmos DB 資料庫帳戶名稱。 Regex 模式: |
private
|
path | True |
string |
私人端點連線的名稱。 |
resource
|
path | True |
string |
資源群組的名稱。 名稱不區分大小寫。 |
subscription
|
path | True |
string |
目標訂用帳戶的標識碼。 |
api-version
|
query | True |
string |
要用於這項作業的 API 版本。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
properties.groupId |
string |
私人端點的群組標識碼。 |
properties.privateEndpoint |
線上所屬的私人端點。 |
|
properties.privateLinkServiceConnectionState |
私人端點連線的連接狀態。 |
|
properties.provisioningState |
string |
布建私人端點的狀態。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
已成功核准或拒絕私人端點連線。 |
|
202 Accepted |
接受。 私人端點連線更新會以異步方式完成。 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
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"
}
}
定義
名稱 | Description |
---|---|
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Private |
私人端點連線 |
Private |
線上所屬的私人端點。 |
Private |
私人端點連線的連接狀態。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細數據。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
PrivateEndpointConnection
私人端點連線
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源的完整資源標識碼。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
資源的名稱 |
properties.groupId |
string |
私人端點的群組標識碼。 |
properties.privateEndpoint |
線上所屬的私人端點。 |
|
properties.privateLinkServiceConnectionState |
私人端點連線的連接狀態。 |
|
properties.provisioningState |
string |
布建私人端點的狀態。 |
type |
string |
資源的型別。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
PrivateEndpointProperty
線上所屬的私人端點。
名稱 | 類型 | Description |
---|---|---|
id |
string |
私人端點的資源標識碼。 |
PrivateLinkServiceConnectionStateProperty
私人端點連線的連接狀態。
名稱 | 類型 | Description |
---|---|---|
actionsRequired |
string |
基本工作流程以外的任何必要動作(核准/拒絕/中斷連線) |
description |
string |
私人鏈接服務連線描述。 |
status |
string |
私人鏈接服務連線狀態。 |