Bookshelf Private Endpoint Connections - Create Or Update

サービス:: Discovery

API バージョン:: 2026-02-01-preview

指定されたプライベートエンドポイント接続を承認または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Discovery/bookshelves/{bookshelfName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2026-02-01-preview

URI パラメーター

名前	/	必須	型	説明
bookshelfName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	本棚の名前
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	PrivateEndpointConnectionProperties	このリソースのリソース固有のプロパティ。

応答

名前	型	説明
200 OK	BookshelfPrivateEndpointConnection	リソース「BookshelfPrivateEndpointConnection」の更新操作が成功しました
201 Created	BookshelfPrivateEndpointConnection	リソース「BookshelfPrivateEndpointConnection」作成操作が成功しましたヘッダー Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

BookshelfPrivateEndpointConnection

リソース「BookshelfPrivateEndpointConnection」の更新操作が成功しました

201 Created

BookshelfPrivateEndpointConnection

リソース「BookshelfPrivateEndpointConnection」作成操作が成功しました

ヘッダー

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

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

スコープ

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

例

BookshelfPrivateEndpointConnections_CreateOrUpdate_MaximumSet

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/bookshelves/a65f3c23bf2baa5bd4/privateEndpointConnections/connection?api-version=2026-02-01-preview

{
  "properties": {
    "privateEndpoint": {},
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "lknyprq",
      "actionsRequired": "vgqhrxvmviabfgmafqtbej"
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/bookshelves/a65f3c23bf2baa5bd4/privateEndpointConnections/connection",
  "name": "connection",
  "type": "Microsoft.Discovery/bookshelves/privateEndpointConnections",
  "systemData": {
    "createdBy": "ly",
    "createdByType": "User",
    "createdAt": "2026-02-10T17:26:12.585Z",
    "lastModifiedBy": "xxc",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2026-02-10T17:26:12.586Z"
  },
  "properties": {
    "groupIds": [
      "nhws"
    ],
    "privateEndpoint": {
      "id": "vbt"
    },
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "lknyprq",
      "actionsRequired": "vgqhrxvmviabfgmafqtbej"
    },
    "provisioningState": "Succeeded"
  }
}

状態コード:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus
Retry-After: 10

{
  "id": "/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/bookshelves/a65f3c23bf2baa5bd4/privateEndpointConnections/connection",
  "name": "connection",
  "type": "Microsoft.Discovery/bookshelves/privateEndpointConnections",
  "systemData": {
    "createdBy": "ly",
    "createdByType": "User",
    "createdAt": "2026-02-10T17:26:12.585Z",
    "lastModifiedBy": "xxc",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2026-02-10T17:26:12.586Z"
  },
  "properties": {
    "groupIds": [
      "nhws"
    ],
    "privateEndpoint": {
      "id": "vbt"
    },
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "lknyprq",
      "actionsRequired": "vgqhrxvmviabfgmafqtbej"
    },
    "provisioningState": "Succeeded"
  }
}

定義

名前	説明
BookshelfPrivateEndpointConnection	Bookshelfのプライベートエンドポイント接続リソース。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
PrivateEndpoint	プライベートエンドポイントリソース。
PrivateEndpointConnectionProperties	プライベートエンドポイント接続のプロパティ。
PrivateEndpointConnectionProvisioningState	現在のプロビジョニング状態。
PrivateEndpointServiceConnectionStatus	プライベートエンドポイント接続の状態。
PrivateLinkServiceConnectionState	サービスコンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。
systemData	リソースの作成と最後の変更に関連するメタデータ。

BookshelfPrivateEndpointConnection

Object

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

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties	PrivateEndpointConnectionProperties	このリソースのリソース固有のプロパティ。
systemData	systemData	create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

createdByType

列挙

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

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

PrivateEndpoint

Object

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

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

PrivateEndpointConnectionProperties

Object

プライベートエンドポイント接続のプロパティ。

名前	型	説明
groupIds	string[]	プライベートエンドポイントリソースのグループ ID。
privateEndpoint	PrivateEndpoint	プライベートエンドポイントリソース。
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	サービスコンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。
provisioningState	PrivateEndpointConnectionProvisioningState	プライベートエンドポイント接続リソースのプロビジョニング状態。

PrivateEndpointConnectionProvisioningState

列挙

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

値	説明
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

列挙

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

値	説明
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

サービスコンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。

名前	型	説明
actionsRequired	string	サービスプロバイダーの変更にコンシューマーの更新が必要かどうかを示すメッセージ。
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 の種類。

次の方法で共有

Bookshelf Private Endpoint Connections - Create Or Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

BookshelfPrivateEndpointConnections_CreateOrUpdate_MaximumSet

要求のサンプル

応答のサンプル

定義

BookshelfPrivateEndpointConnection

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrivateEndpoint

PrivateEndpointConnectionProperties

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

systemData