다음을 통해 공유


Private Endpoint Connections - Put

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2022-07-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

키 자격 증명 모음 이름입니다.

regex 패턴: ^[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

샘플 요청

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=2022-07-01

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

샘플 응답

{
  "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

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

Name 형식 Description
None

string

CloudError

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

Name 형식 Description
error

CloudErrorBody

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

CloudErrorBody

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

Name 형식 Description
code

string

오류 코드 프로그래밍 방식으로 사용할 수 있는 니모닉입니다.

message

string

사용자에게 친숙한 오류 메시지입니다. 메시지는 일반적으로 지역화되며 서비스 버전에 따라 다를 수 있습니다.

PrivateEndpoint

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

Name 형식 Description
id

string

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

PrivateEndpointConnection

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

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

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

Name 형식 Description
Creating

string

Deleting

string

Disconnected

string

Failed

string

Succeeded

string

Updating

string

PrivateEndpointServiceConnectionStatus

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

Name 형식 Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PrivateLinkServiceConnectionState

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

Name 형식 Description
actionsRequired

ActionsRequired

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

description

string

승인 또는 거부 이유입니다.

status

PrivateEndpointServiceConnectionStatus

키 자격 증명 모음 소유자가 연결을 승인, 거부 또는 제거했는지 여부를 나타냅니다.