Creates a new role for your AWS account. For more information about roles, go to Working
with Roles. For information about limitations on role names and the number of
roles you can create, go to Limitations on IAM Entities in Using AWS Identity and Access Management.
The example policy grants permission to an EC2 instance to assume the role. The policy is URL-encoded according to RFC 3986. For more information about RFC 3986, go to http://www.faqs.org/rfcs/rfc3986.html.
Declaration Syntax| C# |
CreateRoleResponse CreateRole( CreateRoleRequest request )
Parameters- request (CreateRoleRequest)
- Container for the necessary parameters to execute the CreateRole service method.
Return ValueThe response from the CreateRole service method, as returned by IdentityManagementService.
Exceptions| Exception | Condition |
|---|---|
| EntityAlreadyExistsException |
The request was rejected because it attempted to create a resource that already exists.
|
| LimitExceededException |
The request was rejected because it attempted to create resources beyond the current
AWS account limits. The error message describes the limit exceeded.
|
| MalformedPolicyDocumentException |
The request was rejected because the policy document was malformed. The error message describes
the specific error.
|