Private Endpoint Connections - Update By Host Pool

サービス:: Desktop Virtualization

API バージョン:: 2025-10-10

プライベートエンドポイント接続を承認または拒否します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2025-10-10

URI パラメーター

名前	/	必須	型	説明
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	指定されたリソース・グループ内のホスト・プールの名前
privateEndpointConnectionName	path	True	string	Azure リソースに関連付けられているプライベートエンドポイント接続の名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
properties.privateLinkServiceConnectionState	True	PrivateLinkServiceConnectionState	サービスconsumerとプロバイダー間の接続の状態に関する情報の集合体です。
properties.privateEndpoint		PrivateEndpoint	プライベートエンドポイントリソース。

応答

名前	型	説明
200 OK	PrivateEndpointConnectionWithSystemData	正常に更新されました。
Other Status Codes	CloudError	操作が失敗した理由を説明する自動化エラー応答。

例

PrivateEndpointConnection_UpdateByHostPool

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/privateEndpointConnections/hostPool1.377103f1-5179-4bdf-8556-4cdd3207cc5b?api-version=2025-10-10

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by admin@consoto.com",
      "actionsRequired": "None"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "hostPool1.377103f1-5179-4bdf-8556-4cdd3207cc5b",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostpools/hostPool1/privateEndpointConnections/hostPool1.377103f1-5179-4bdf-8556-4cdd3207cc5b",
  "type": "Microsoft.DesktopVirtualization/hostpools/privateEndpointConnections",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup2/providers/Microsoft.Network/privateEndpoints/endpointName1"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by admin@consoto.com",
      "actionsRequired": "None"
    }
  }
}

定義

名前	説明
CloudError	クラウドエラーオブジェクト。
CloudErrorProperties	クラウドエラーオブジェクトのプロパティ。
createdByType	リソースを作成した ID の種類。
PrivateEndpoint	プライベートエンドポイントリソース。
PrivateEndpointConnectionProvisioningState	現在のプロビジョニング状態。
PrivateEndpointConnectionWithSystemData	プライベートエンドポイント接続リソース。
PrivateEndpointServiceConnectionStatus	プライベートエンドポイント接続の状態。
PrivateLinkServiceConnectionState	サービスconsumerとプロバイダー間の接続の状態に関する情報の集合体です。
systemData	リソースの作成と最後の変更に関連するメタデータ。

CloudError

Object

クラウドエラーオブジェクト。

名前	型	説明
error	CloudErrorProperties	クラウドエラーオブジェクトのプロパティ。

CloudErrorProperties

Object

クラウドエラーオブジェクトのプロパティ。

名前	型	説明
code	string	エラーコード
message	string	操作が失敗した理由を示すエラーメッセージ。

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

PrivateEndpoint

Object

プライベートエンドポイントリソース。

名前	型	説明
id	string	プライベートエンドポイントの ARM 識別子。

PrivateEndpointConnectionProvisioningState

列挙

現在のプロビジョニング状態。

値	説明
Succeeded
Creating
Deleting
Failed

PrivateEndpointConnectionWithSystemData

Object

プライベートエンドポイント接続リソース。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.groupIds	string[]	プライベートエンドポイントリソースのグループ ID。
properties.privateEndpoint	PrivateEndpoint	プライベートエンドポイントリソース。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	サービスconsumerとプロバイダー間の接続の状態に関する情報の集合体です。
properties.provisioningState	PrivateEndpointConnectionProvisioningState	プライベートエンドポイント接続リソースのプロビジョニング状態。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

PrivateEndpointServiceConnectionStatus

列挙

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

値	説明
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

サービスconsumerとプロバイダー間の接続の状態に関する情報の集合体です。

名前	型	説明
actionsRequired	string	サービスプロバイダーの変更がconsumerに更新を必要とするかどうかを示すメッセージです。
description	string	接続の承認/拒否の理由。
status	PrivateEndpointServiceConnectionStatus	接続がサービスの所有者によって承認/拒否/削除されたかどうかを示します。

systemData

Object

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

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

次の方法で共有

Private Endpoint Connections - Update By Host Pool

URI パラメーター

要求本文

応答

例

PrivateEndpointConnection_UpdateByHostPool

要求のサンプル

応答のサンプル

定義

CloudError

CloudErrorProperties

createdByType

PrivateEndpoint

PrivateEndpointConnectionProvisioningState

PrivateEndpointConnectionWithSystemData

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

systemData