공통 매개 변수 및 헤더
다음 정보는 Key Vault 리소스에 대해 수행할 수 있는 모든 작업에 공통적입니다.
- HTTP
Host
헤더는 항상 존재해야 하며 자격 증명 모음 호스트 이름을 지정해야 합니다. 예:Host: contoso.vault.azure.net
대부분의 클라이언트 기술은 URI의Host
헤더를 채웁니다. 예를 들어GET https://contoso.vault.azure.net/secrets/mysecret{...}
는Host
를contoso.vault.azure.net
으로 설정합니다.GET https://10.0.0.23/secrets/mysecret{...}
같은 원시 IP 주소를 사용하여 Key Vault에 액세스하는 경우Host
헤더의 자동 값이 잘못되고Host
헤더에 자격 증명 모음 호스트 이름이 포함되어 있는지 수동으로 확인해야 합니다. {api-version}
을 URI의 API 버전으로 바꿉니다.{subscription-id}
를 URI의 구독 ID로 바꿉니다.{resource-group-name}
을 리소스 그룹으로 바꿉니다. 자세한 내용은 리소스 그룹을 사용하여 Azure 리소스 관리를 참조하세요.{vault-name}
을 URI에서 사용자의 Key Vault로 바꿉니다.- 콘텐츠 형식 헤더를 application/json으로 설정합니다.
- 인증 헤더를 Microsoft Entra ID에서 가져온 JSON 웹 토큰으로 설정합니다. 자세한 내용은 Azure Resource Manager 인증 요청을 참조하세요.
공통 오류 응답
서비스는 성공 또는 실패를 나타내는 HTTP 상태 코드를 사용합니다. 또한 실패에는 다음과 같은 형식의 응답이 포함됩니다.
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
요소 이름 | Type | 설명 |
---|---|---|
코드 | string | 발생한 오류의 형식입니다. |
message | string | 오류 원인에 대한 설명입니다. |