Updating a Specific Policy Instance

Function

This API is used to update a specific policy instance.

URI

PUT /v1/policyinstances/{policyinstanceid}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
policyinstanceid	Yes	String	Policy instance ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	Identity authentication information. Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
constraintTemplateID	No	String	Policy template ID
enforcementAction	No	String	Policy enforcement action. The options are warn and deny.
namespaces	No	Array of strings	Namespace
parameters	No	Object	Policy instance parameters

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
jobID	String	Job ID

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
-	String	-

Status code: 500

**Table 6** Response body parameters
Parameter	Type	Description
-	String	-

Example Requests

Updating a specific policy instance

PUT https://ucs.myhuaweicloud.com/v1/policyinstances/{policyinstanceid}

{
  "enforcementAction" : "warn",
  "namespaces" : [ "default" ],
  "parameters" : {
    "volumes" : [ "xxxxxx" ]
  },
  "constraintTemplateID" : "f1519ae2-adf8-11ed-9f9c-0255ac100186"
}

Example Responses

Status code: 200

ID of the job for updating a policy instance returned

{
  "jobID" : "ae4e4da4-92f7-48c9-822d-6a9978d30d16"
}

Status Codes

Status Code	Description
200	ID of the job for updating a policy instance returned
400	Client request error. The server could not execute the request.
500	Internal server error

Error Codes

See Error Codes.

Parent topic: Policy Management

Previous topic: Obtaining a Specific Policy Instance

Next topic: Obtaining the Job Related to a Specific Policy Instance

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot