Dell Technologies ECS REST API

Search (SHIFT+S)




Create Policy Version

POST /iam?Action=CreatePolicyVersion

Creates a new version of the specified managed policy.


Query Parameters

PolicyArnARN of the IAM policy to add a new version.
PolicyDocumentThe policy document in JSON format.
SetAsDefaultSpecifies whether to set this version as the policy's default version.

Required Roles

This call has no restrictions.


Request Payload

No Request Payload


Response Body

Field Description Type Notes
CreatePolicyVersionResponse
CreatePolicyVersionResult    
PolicyVersion    
CreateDate The date and time, in ISO 8601 date-time format, when the policy was created. String
Document The policy document, URL-encoded compliant with RFC 3986. String
IsDefaultVersion Specifies whether the policy version is set as the policy's default version. Boolean
VersionId The identifier for the policy version. String
ResponseMetadata    
RequestId String

Examples

Request
NOTE: Policy must be url encoded for query parameter.
Example:
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "iam:GetPolicyVersion",
        "iam:GetUser",
        "iam:GetPolicy",
        "iam:GetGroupPolicy",
        "iam:GetRole",
        "iam:GetAccessKeyLastUsed",
        "iam:GetGroup",
        "iam:GetUserPolicy"
      ],
      "Resource": "*",
      "Effect": "Allow",
      "Sid": "VisualEditor0"
    }
  ]
}


POST https://192.168.0.0:4443/iam?PolicyArn=urn:ecs:iam::ns:policy/FinanceTeamPolicy&PolicyDocument=%7B%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%0A%20%20%22Statement%22%3A%20%5B%0A%20%20%20%20%7B%0A%20%20%20%20%20%20%22Sid%22%3A%20%22VisualEditor0%22%2C%0A%20%20%20%20%20%20%22Effect%22%3A%20%22Allow%22%2C%0A%20%20%20%20%20%20%22Action%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%22iam%3AGetPolicyVersion%22%2C%0A%20%20%20%20%20%20%20%20%22iam%3AGetUser%22%2C%0A%20%20%20%20%20%20%20%20%22iam%3AGetPolicy%22%2C%0A%20%20%20%20%20%20%20%20%22iam%3AGetGroupPolicy%22%2C%0A%20%20%20%20%20%20%20%20%22iam%3AGetRole%22%2C%0A%20%20%20%20%20%20%20%20%22iam%3AGetAccessKeyLastUsed%22%2C%0A%20%20%20%20%20%20%20%20%22iam%3AGetGroup%22%2C%0A%20%20%20%20%20%20%20%20%22iam%3AGetUserPolicy%22%0A%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%22Resource%22%3A%20%22*%22%0A%20%20%20%20%7D%0A%20%20%5D%0A%7D&SetAsDefault=true&Action=CreatePolicyVersion

Accept: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
x-emc-namespace: <namespace>
Response
HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:CreatePolicyVersionResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:17178fe9282:fb56:31</RequestId>
    </ResponseMetadata>
    <CreatePolicyVersionResult>
        <PolicyVersion>
            <CreateDate>2020-04-15T21:58:14Z</CreateDate>
            <Document>%7B%22Version%22%3A%222012-10-17%22%2C%22Statement%22%3A%5B%7B%22Action%22%3A%5B%22iam%3AGetPolicyVersion%22%2C%22iam%3AGetUser%22%2C%22iam%3AGetPolicy%22%2C%22iam%3AGetGroupPolicy%22%2C%22iam%3AGetRole%22%2C%22iam%3AGetAccessKeyLastUsed%22%2C%22iam%3AGetGroup%22%2C%22iam%3AGetUserPolicy%22%5D%2C%22Resource%22%3A%22*%22%2C%22Effect%22%3A%22Allow%22%2C%22Sid%22%3A%22VisualEditor0%22%7D%5D%7D</Document>
            <IsDefaultVersion>true</IsDefaultVersion>
            <VersionId>v3</VersionId>
        </PolicyVersion>
    </CreatePolicyVersionResult>
</ns2:CreatePolicyVersionResponse>