다음을 통해 공유


공통 매개 변수 및 헤더

다음 정보는 Key Vault 리소스에 대해 수행할 수 있는 모든 작업에 공통적입니다.

  • HTTP Host 헤더는 항상 존재해야 하며 자격 증명 모음 호스트 이름을 지정해야 합니다. 예: Host: contoso.vault.azure.net 대부분의 클라이언트 기술은 URI의 Host 헤더를 채웁니다. 예를 들어 GET https://contoso.vault.azure.net/secrets/mysecret{...}Hostcontoso.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 오류 원인에 대한 설명입니다.

참고 항목

Azure Key Vault REST API 참조