Private Endpoint Connections - Put

서비스:

Key Vault

API 버전:

2024-11-01

키 자격 증명 모음과 연결된 지정된 프라이빗 엔드포인트 연결을 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2024-11-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
privateEndpointConnectionName	path	True	string	키 자격 증명 모음과 연결된 프라이빗 엔드포인트 연결의 이름입니다.
resourceGroupName	path	True	string	키 자격 증명 모음을 포함하는 리소스 그룹의 이름.
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.
vaultName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	키 자격 증명 모음의 이름입니다.
api-version	query	True	string	클라이언트 API 버전입니다.

요청 본문

Name	형식	Description
etag	string	프라이빗 엔드포인트 연결 상태가 변경될 때마다 수정됩니다.
properties.privateEndpoint	PrivateEndpoint	프라이빗 엔드포인트 개체의 속성입니다.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	프라이빗 링크 연결의 승인 상태입니다.

응답

Name	형식	Description
200 OK	PrivateEndpointConnection	프라이빗 엔드포인트 연결의 상태가 성공적으로 업데이트되었습니다. 헤더 Retry-After: integer Azure-AsyncOperation: string
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

KeyVaultPutPrivateEndpointConnection

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/vaults/sample-vault/privateEndpointConnections/sample-pec?api-version=2024-11-01

{
  "etag": "",
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "My name is Joe and I'm approving this."
    }
  }
}

샘플 응답

상태 코드:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-group/providers/Microsoft.KeyVault/vaults/sample-vault/privateEndpointConnections/sample-pec",
  "name": "sample-pec",
  "type": "Microsoft.KeyVault/vaults/privateEndpointConnections",
  "etag": "",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/00000000-0000-0000-1234-000000000000/resourceGroups/sample-group/providers/Microsoft.Network/privateEndpoints/sample-pe"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "My name is Joe and I'm approving this.",
      "actionsRequired": "None"
    }
  }
}

정의

Name	Description
ActionsRequired	서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.
CloudError	Key Vault 리소스 공급자의 오류 응답
CloudErrorBody	Key Vault 리소스 공급자의 오류 응답
PrivateEndpoint	프라이빗 엔드포인트 개체 속성.
PrivateEndpointConnection	프라이빗 엔드포인트 연결 리소스입니다.
PrivateEndpointConnectionProvisioningState	현재 프로비저닝 상태입니다.
PrivateEndpointServiceConnectionStatus	프라이빗 엔드포인트 연결 상태입니다.
PrivateLinkServiceConnectionState	프라이빗 링크 연결의 승인 상태를 나타내는 개체입니다.

ActionsRequired

열거형

서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.

값	Description
None

CloudError

Object

Key Vault 리소스 공급자의 오류 응답

Name	형식	Description
error	CloudErrorBody	Key Vault 리소스 공급자의 오류 응답

CloudErrorBody

Object

Key Vault 리소스 공급자의 오류 응답

Name	형식	Description
code	string	오류 코드입니다. 이것은 프로그래밍 방식으로 사용할 수 있는 니모닉입니다.
message	string	사용자에게 친숙한 오류 메시지입니다. 메시지는 일반적으로 현지화되며 서비스 버전에 따라 다를 수 있습니다.

PrivateEndpoint

Object

프라이빗 엔드포인트 개체 속성.

Name	형식	Description
id	string	프라이빗 엔드포인트 리소스의 전체 식별자입니다.

PrivateEndpointConnection

Object

프라이빗 엔드포인트 연결 리소스입니다.

Name	형식	Description
etag	string	프라이빗 엔드포인트 연결 상태가 변경될 때마다 수정됩니다.
id	string	키 자격 증명 모음 리소스의 정규화된 식별자입니다.
location	string	키 자격 증명 모음 리소스의 Azure 위치입니다.
name	string	키 자격 증명 모음 리소스의 이름입니다.
properties.privateEndpoint	PrivateEndpoint	프라이빗 엔드포인트 개체의 속성입니다.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	프라이빗 링크 연결의 승인 상태입니다.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	프라이빗 엔드포인트 연결의 프로비전 상태입니다.
tags	object	키 자격 증명 모음 리소스에 할당된 태그입니다.
type	string	키 자격 증명 모음 리소스의 리소스 종류입니다.

PrivateEndpointConnectionProvisioningState

열거형

현재 프로비저닝 상태입니다.

값	Description
Succeeded
Creating
Updating
Deleting
Failed
Disconnected

PrivateEndpointServiceConnectionStatus

열거형

프라이빗 엔드포인트 연결 상태입니다.

값	Description
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Object

프라이빗 링크 연결의 승인 상태를 나타내는 개체입니다.

Name	형식	Description
actionsRequired	ActionsRequired	서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.
description	string	승인 또는 거부의 이유입니다.
status	PrivateEndpointServiceConnectionStatus	키 자격 증명 모음 소유자가 연결을 승인, 거부 또는 제거했는지 여부를 나타냅니다.