Private Endpoint Connections - Create Or Update
Cognitive Services アカウントに関連付けられている指定されたプライベート エンドポイント接続の状態を更新します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2023-05-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
account
|
path | True |
string |
Cognitive Services アカウントの名前。 正規表現パターン: |
private
|
path | True |
string |
Cognitive Services アカウントに関連付けられているプライベート エンドポイント接続の名前 |
resource
|
path | True |
string |
リソース グループの名前。 名前の大文字と小文字は区別されます。 |
subscription
|
path | True |
string |
ターゲット サブスクリプションの ID。 |
api-version
|
query | True |
string |
この操作に使用する API バージョン。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
location |
string |
プライベート エンドポイント接続の場所 |
properties |
リソースのプロパティ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK -- プライベート エンドポイント接続プロパティを正常に更新します。 |
|
202 Accepted |
操作が正常に開始され、非同期的に完了する場合は HTTP 202 (Accepted)。 |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 |
例
PutPrivateEndpointConnection
要求のサンプル
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.CognitiveServices/accounts/sto9699/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2023-05-01
{
"properties": {
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Auto-Approved"
}
}
}
応答のサンプル
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res7231/providers/Microsoft.CognitiveServices/accounts/sto288/privateEndpointConnections/{privateEndpointConnectionName}",
"name": "{privateEndpointConnectionName}",
"type": "Microsoft.CognitiveServices/accounts/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/{subscription-id}/resourceGroups/res7231/providers/Microsoft.Network/privateEndpoints/petest01"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Auto-Approved",
"actionsRequired": "None"
}
}
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res7231/providers/Microsoft.CognitiveServices/accounts/sto288/privateEndpointConnections/{privateEndpointConnectionName}",
"name": "{privateEndpointConnectionName}",
"type": "Microsoft.CognitiveServices/accounts/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/{subscription-id}/resourceGroups/res7231/providers/Microsoft.Network/privateEndpoints/petest01"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Auto-Approved",
"actionsRequired": "None"
}
}
}
定義
名前 | 説明 |
---|---|
created |
リソースを作成した ID の種類。 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Private |
プライベート エンドポイント リソース。 |
Private |
プライベート エンドポイント接続リソース。 |
Private |
PrivateEndpointConnectProperties のプロパティ。 |
Private |
現在のプロビジョニング状態。 |
Private |
プライベート エンドポイント接続の状態。 |
Private |
サービス コンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。 |
system |
リソースの作成と最後の変更に関連するメタデータ。 |
createdByType
リソースを作成した ID の種類。
名前 | 型 | 説明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
PrivateEndpoint
プライベート エンドポイント リソース。
名前 | 型 | 説明 |
---|---|---|
id |
string |
プライベート エンドポイントの ARM 識別子 |
PrivateEndpointConnection
プライベート エンドポイント接続リソース。
名前 | 型 | 説明 |
---|---|---|
etag |
string |
リソース Etag。 |
id |
string |
リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
プライベート エンドポイント接続の場所 |
name |
string |
リソースの名前 |
properties |
リソースのプロパティ。 |
|
systemData |
リソースの作成と最後の変更に関連するメタデータ。 |
|
type |
string |
リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProperties
PrivateEndpointConnectProperties のプロパティ。
名前 | 型 | 説明 |
---|---|---|
groupIds |
string[] |
プライベート リンク リソース グループ ID。 |
privateEndpoint |
プライベート エンドポイントのリソース。 |
|
privateLinkServiceConnectionState |
サービス コンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。 |
|
provisioningState |
プライベート エンドポイント接続リソースのプロビジョニング状態。 |
PrivateEndpointConnectionProvisioningState
現在のプロビジョニング状態。
名前 | 型 | 説明 |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
PrivateEndpointServiceConnectionStatus
プライベート エンドポイント接続の状態。
名前 | 型 | 説明 |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
サービス コンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。
名前 | 型 | 説明 |
---|---|---|
actionsRequired |
string |
サービス プロバイダーの変更にコンシューマーに対する更新が必要かどうかを示すメッセージ。 |
description |
string |
接続の承認/拒否の理由。 |
status |
サービスの所有者によって接続が承認/拒否/削除されたかどうかを示します。 |
systemData
リソースの作成と最後の変更に関連するメタデータ。
名前 | 型 | 説明 |
---|---|---|
createdAt |
string |
リソース作成のタイムスタンプ (UTC)。 |
createdBy |
string |
リソースを作成した ID。 |
createdByType |
リソースを作成した ID の種類。 |
|
lastModifiedAt |
string |
リソースの最終変更のタイムスタンプ (UTC) |
lastModifiedBy |
string |
リソースを最後に変更した ID。 |
lastModifiedByType |
リソースを最後に変更した ID の種類。 |