Creating or Canceling an Agency Authorization for CBH._Agency Authorization_API Description_API Reference

This API is used to create or cancel an agency authorization for CBH.

For details, see Calling APIs.

POST /v2/{project_id}/cbs/agency/authorization

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID, which uniquely identifies a project. To obtain the value, see Obtaining a Project ID. Constraints N/A Range The value can contain 32 characters. Only letters and digits are allowed. Default Value N/A

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. You can obtain the token by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. For details, see Obtaining a User Token. Constraints N/A Range String type. The value can contain 1 to 28,000 characters. Default Value N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
authorization	Yes	AgencyAuthorizeInfo object	Request object for setting CBH agencies for Cloud Secret Management Service (CSMS) and Key Management Service (KMS). Either KMS or CSMS must be specified.

**Table 4** AgencyAuthorizeInfo
Parameter	Mandatory	Type	Description
csms	No	Boolean	Credential management permission information.
kms	No	Boolean	Key management permission information.

Status code: 200

None

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_description	String	Incorrect request parameters.

Status code: 401

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_description	String	Token verification failed.

Status code: 403

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_description	String	Permissions required.

Status code: 404

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_description	String	Not CBH instances found.

{
  "authorization" : {
    "csms" : true
  }
}

None

Status Code	Description
200	Authorize Csms And Kms Success
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found

Creating or Canceling an Agency Authorization for CBH.