@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonVerifiedPermissionsClient extends AmazonWebServiceClient implements AmazonVerifiedPermissions
Amazon Verified Permissions is a permissions management service from Amazon Web Services. You can use Verified Permissions to manage permissions for your application, and authorize user access based on those permissions. Using Verified Permissions, application developers can grant access based on information about the users, resources, and requested actions. You can also evaluate additional information like group membership, attributes of the resources, and session context, such as time of request and IP addresses. Verified Permissions manages these permissions by letting you create and store authorization policies for your applications, such as consumer-facing web sites and enterprise business systems.
Verified Permissions uses Cedar as the policy language to express your permission requirements. Cedar supports both role-based access control (RBAC) and attribute-based access control (ABAC) authorization models.
For more information about configuring, administering, and using Amazon Verified Permissions in your applications, see the Amazon Verified Permissions User Guide.
For more information about the Cedar policy language, see the Cedar Policy Language Guide.
When you write Cedar policies that reference principals, resources and actions, you can define the unique identifiers used for each of those elements. We strongly recommend that you follow these best practices:
Use values like universally unique identifiers (UUIDs) for all principal and resource identifiers.
For example, if user jane
leaves the company, and you later let someone else use the name
jane
, then that new user automatically gets access to everything granted by policies that still
reference User::"jane"
. Cedar can’t distinguish between the new user and the old. This applies to both
principal and resource identifiers. Always use identifiers that are guaranteed unique and never reused to ensure that
you don’t unintentionally grant access because of the presence of an old identifier in a policy.
Where you use a UUID for an entity, we recommend that you follow it with the // comment specifier and the ‘friendly’ name of your entity. This helps to make your policies easier to understand. For example: principal == User::"a1b2c3d4-e5f6-a1b2-c3d4-EXAMPLE11111", // alice
Do not include personally identifying, confidential, or sensitive information as part of the unique identifier for your principals or resources. These identifiers are included in log entries shared in CloudTrail trails.
Several operations return structures that appear similar, but have different purposes. As new functionality is added to the product, the structure used in a parameter of one operation might need to change in a way that wouldn't make sense for the same parameter in a different operation. To help you understand the purpose of each, the following naming convention is used for the structures:
Parameter type structures that end in Detail
are used in Get
operations.
Parameter type structures that end in Item
are used in List
operations.
Parameter type structures that use neither suffix are used in the mutating (create and update) operations.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
BatchIsAuthorizedResult |
batchIsAuthorized(BatchIsAuthorizedRequest request)
Makes a series of decisions about multiple authorization requests for one principal or resource.
|
BatchIsAuthorizedWithTokenResult |
batchIsAuthorizedWithToken(BatchIsAuthorizedWithTokenRequest request)
Makes a series of decisions about multiple authorization requests for one token.
|
static AmazonVerifiedPermissionsClientBuilder |
builder() |
CreateIdentitySourceResult |
createIdentitySource(CreateIdentitySourceRequest request)
Adds an identity source to a policy store–an Amazon Cognito user pool or OpenID Connect (OIDC) identity provider
(IdP).
|
CreatePolicyResult |
createPolicy(CreatePolicyRequest request)
Creates a Cedar policy and saves it in the specified policy store.
|
CreatePolicyStoreResult |
createPolicyStore(CreatePolicyStoreRequest request)
Creates a policy store.
|
CreatePolicyTemplateResult |
createPolicyTemplate(CreatePolicyTemplateRequest request)
Creates a policy template.
|
DeleteIdentitySourceResult |
deleteIdentitySource(DeleteIdentitySourceRequest request)
Deletes an identity source that references an identity provider (IdP) such as Amazon Cognito.
|
DeletePolicyResult |
deletePolicy(DeletePolicyRequest request)
Deletes the specified policy from the policy store.
|
DeletePolicyStoreResult |
deletePolicyStore(DeletePolicyStoreRequest request)
Deletes the specified policy store.
|
DeletePolicyTemplateResult |
deletePolicyTemplate(DeletePolicyTemplateRequest request)
Deletes the specified policy template from the policy store.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues
where a service isn't acting as expected.
|
GetIdentitySourceResult |
getIdentitySource(GetIdentitySourceRequest request)
Retrieves the details about the specified identity source.
|
GetPolicyResult |
getPolicy(GetPolicyRequest request)
Retrieves information about the specified policy.
|
GetPolicyStoreResult |
getPolicyStore(GetPolicyStoreRequest request)
Retrieves details about a policy store.
|
GetPolicyTemplateResult |
getPolicyTemplate(GetPolicyTemplateRequest request)
Retrieve the details for the specified policy template in the specified policy store.
|
GetSchemaResult |
getSchema(GetSchemaRequest request)
Retrieve the details for the specified schema in the specified policy store.
|
IsAuthorizedResult |
isAuthorized(IsAuthorizedRequest request)
Makes an authorization decision about a service request described in the parameters.
|
IsAuthorizedWithTokenResult |
isAuthorizedWithToken(IsAuthorizedWithTokenRequest request)
Makes an authorization decision about a service request described in the parameters.
|
ListIdentitySourcesResult |
listIdentitySources(ListIdentitySourcesRequest request)
Returns a paginated list of all of the identity sources defined in the specified policy store.
|
ListPoliciesResult |
listPolicies(ListPoliciesRequest request)
Returns a paginated list of all policies stored in the specified policy store.
|
ListPolicyStoresResult |
listPolicyStores(ListPolicyStoresRequest request)
Returns a paginated list of all policy stores in the calling Amazon Web Services account.
|
ListPolicyTemplatesResult |
listPolicyTemplates(ListPolicyTemplatesRequest request)
Returns a paginated list of all policy templates in the specified policy store.
|
PutSchemaResult |
putSchema(PutSchemaRequest request)
Creates or updates the policy schema in the specified policy store.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
UpdateIdentitySourceResult |
updateIdentitySource(UpdateIdentitySourceRequest request)
Updates the specified identity source to use a new identity provider (IdP), or to change the mapping of
identities from the IdP to a different principal entity type.
|
UpdatePolicyResult |
updatePolicy(UpdatePolicyRequest request)
Modifies a Cedar static policy in the specified policy store.
|
UpdatePolicyStoreResult |
updatePolicyStore(UpdatePolicyStoreRequest request)
Modifies the validation setting for a policy store.
|
UpdatePolicyTemplateResult |
updatePolicyTemplate(UpdatePolicyTemplateRequest request)
Updates the specified policy template.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
public static AmazonVerifiedPermissionsClientBuilder builder()
public BatchIsAuthorizedResult batchIsAuthorized(BatchIsAuthorizedRequest request)
Makes a series of decisions about multiple authorization requests for one principal or resource. Each request
contains the equivalent content of an IsAuthorized
request: principal, action, resource, and
context. Either the principal
or the resource
parameter must be identical across all
requests. For example, Verified Permissions won't evaluate a pair of requests where bob
views
photo1
and alice
views photo2
. Authorization of bob
to view
photo1
and photo2
, or bob
and alice
to view
photo1
, are valid batches.
The request is evaluated against all policies in the specified policy store that match the entities that you
declare. The result of the decisions is a series of Allow
or Deny
responses, along with
the IDs of the policies that produced each decision.
The entities
of a BatchIsAuthorized
API request can contain up to 100 principals and up
to 100 resources. The requests
of a BatchIsAuthorized
API request can contain up to 30
requests.
The BatchIsAuthorized
operation doesn't have its own IAM permission. To authorize this operation for
Amazon Web Services principals, include the permission verifiedpermissions:IsAuthorized
in their IAM
policies.
batchIsAuthorized
in interface AmazonVerifiedPermissions
batchIsAuthorizedRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic BatchIsAuthorizedWithTokenResult batchIsAuthorizedWithToken(BatchIsAuthorizedWithTokenRequest request)
Makes a series of decisions about multiple authorization requests for one token. The principal in this request comes from an external identity source in the form of an identity or access token, formatted as a JSON web token (JWT). The information in the parameters can also define additional context that Verified Permissions can include in the evaluations.
The request is evaluated against all policies in the specified policy store that match the entities that you
provide in the entities declaration and in the token. The result of the decisions is a series of
Allow
or Deny
responses, along with the IDs of the policies that produced each
decision.
The entities
of a BatchIsAuthorizedWithToken
API request can contain up to 100
resources and up to 99 user groups. The requests
of a BatchIsAuthorizedWithToken
API
request can contain up to 30 requests.
The BatchIsAuthorizedWithToken
operation doesn't have its own IAM permission. To authorize this
operation for Amazon Web Services principals, include the permission
verifiedpermissions:IsAuthorizedWithToken
in their IAM policies.
batchIsAuthorizedWithToken
in interface AmazonVerifiedPermissions
batchIsAuthorizedWithTokenRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic CreateIdentitySourceResult createIdentitySource(CreateIdentitySourceRequest request)
Adds an identity source to a policy store–an Amazon Cognito user pool or OpenID Connect (OIDC) identity provider (IdP).
After you create an identity source, you can use the identities provided by the IdP as proxies for the principal
in authorization queries that use the IsAuthorizedWithToken or BatchIsAuthorizedWithToken API operations. These identities take the form of tokens that contain claims
about the user, such as IDs, attributes and group memberships. Identity sources provide identity (ID) tokens and
access tokens. Verified Permissions derives information about your user and session from token claims. Access
tokens provide action context
to your policies, and ID tokens provide principal
Attributes
.
Tokens from an identity source user continue to be usable until they expire. Token revocation and resource deletion have no effect on the validity of a token in your policy store
To reference a user from this identity source in your Cedar policies, refer to the following syntax examples.
Amazon Cognito user pool: Namespace::[Entity type]::[User pool ID]|[user principal attribute]
, for
example MyCorp::User::us-east-1_EXAMPLE|a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
.
OpenID Connect (OIDC) provider:
Namespace::[Entity type]::[principalIdClaim]|[user principal attribute]
, for example
MyCorp::User::MyOIDCProvider|a1b2c3d4-5678-90ab-cdef-EXAMPLE22222
.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
createIdentitySource
in interface AmazonVerifiedPermissions
createIdentitySourceRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ServiceQuotaExceededException
- The request failed because it would cause a service quota to be exceeded.ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic CreatePolicyResult createPolicy(CreatePolicyRequest request)
Creates a Cedar policy and saves it in the specified policy store. You can create either a static policy or a policy linked to a policy template.
To create a static policy, provide the Cedar policy text in the StaticPolicy
section of the
PolicyDefinition
.
To create a policy that is dynamically linked to a policy template, specify the policy template ID and the
principal and resource to associate with this policy in the templateLinked
section of the
PolicyDefinition
. If the policy template is ever updated, any policies linked to the policy template
automatically use the updated template.
Creating a policy causes it to be validated against the schema in the policy store. If the policy doesn't pass validation, the operation fails and the policy isn't stored.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
createPolicy
in interface AmazonVerifiedPermissions
createPolicyRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ServiceQuotaExceededException
- The request failed because it would cause a service quota to be exceeded.ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic CreatePolicyStoreResult createPolicyStore(CreatePolicyStoreRequest request)
Creates a policy store. A policy store is a container for policy resources.
Although Cedar supports multiple namespaces, Verified Permissions currently supports only one namespace per policy store.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
createPolicyStore
in interface AmazonVerifiedPermissions
createPolicyStoreRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ServiceQuotaExceededException
- The request failed because it would cause a service quota to be exceeded.ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic CreatePolicyTemplateResult createPolicyTemplate(CreatePolicyTemplateRequest request)
Creates a policy template. A template can use placeholders for the principal and resource. A template must be instantiated into a policy by associating it with specific principals and resources to use for the placeholders. That instantiated policy can then be considered in authorization decisions. The instantiated policy works identically to any other policy, except that it is dynamically linked to the template. If the template changes, then any policies that are linked to that template are immediately updated as well.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
createPolicyTemplate
in interface AmazonVerifiedPermissions
createPolicyTemplateRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ServiceQuotaExceededException
- The request failed because it would cause a service quota to be exceeded.ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic DeleteIdentitySourceResult deleteIdentitySource(DeleteIdentitySourceRequest request)
Deletes an identity source that references an identity provider (IdP) such as Amazon Cognito. After you delete the identity source, you can no longer use tokens for identities from that identity source to represent principals in authorization queries made using IsAuthorizedWithToken. operations.
deleteIdentitySource
in interface AmazonVerifiedPermissions
deleteIdentitySourceRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic DeletePolicyResult deletePolicy(DeletePolicyRequest request)
Deletes the specified policy from the policy store.
This operation is idempotent; if you specify a policy that doesn't exist, the request response returns a
successful HTTP 200
status code.
deletePolicy
in interface AmazonVerifiedPermissions
deletePolicyRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic DeletePolicyStoreResult deletePolicyStore(DeletePolicyStoreRequest request)
Deletes the specified policy store.
This operation is idempotent. If you specify a policy store that does not exist, the request response will still return a successful HTTP 200 status code.
deletePolicyStore
in interface AmazonVerifiedPermissions
deletePolicyStoreRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic DeletePolicyTemplateResult deletePolicyTemplate(DeletePolicyTemplateRequest request)
Deletes the specified policy template from the policy store.
This operation also deletes any policies that were created from the specified policy template. Those policies are immediately removed from all future API responses, and are asynchronously deleted from the policy store.
deletePolicyTemplate
in interface AmazonVerifiedPermissions
deletePolicyTemplateRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic GetIdentitySourceResult getIdentitySource(GetIdentitySourceRequest request)
Retrieves the details about the specified identity source.
getIdentitySource
in interface AmazonVerifiedPermissions
getIdentitySourceRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic GetPolicyResult getPolicy(GetPolicyRequest request)
Retrieves information about the specified policy.
getPolicy
in interface AmazonVerifiedPermissions
getPolicyRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic GetPolicyStoreResult getPolicyStore(GetPolicyStoreRequest request)
Retrieves details about a policy store.
getPolicyStore
in interface AmazonVerifiedPermissions
getPolicyStoreRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic GetPolicyTemplateResult getPolicyTemplate(GetPolicyTemplateRequest request)
Retrieve the details for the specified policy template in the specified policy store.
getPolicyTemplate
in interface AmazonVerifiedPermissions
getPolicyTemplateRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic GetSchemaResult getSchema(GetSchemaRequest request)
Retrieve the details for the specified schema in the specified policy store.
getSchema
in interface AmazonVerifiedPermissions
getSchemaRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic IsAuthorizedResult isAuthorized(IsAuthorizedRequest request)
Makes an authorization decision about a service request described in the parameters. The information in the
parameters can also define additional context that Verified Permissions can include in the evaluation. The
request is evaluated against all matching policies in the specified policy store. The result of the decision is
either Allow
or Deny
, along with a list of the policies that resulted in the decision.
isAuthorized
in interface AmazonVerifiedPermissions
isAuthorizedRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic IsAuthorizedWithTokenResult isAuthorizedWithToken(IsAuthorizedWithTokenRequest request)
Makes an authorization decision about a service request described in the parameters. The principal in this
request comes from an external identity source in the form of an identity token formatted as a JSON web token (JWT). The information in the parameters can
also define additional context that Verified Permissions can include in the evaluation. The request is evaluated
against all matching policies in the specified policy store. The result of the decision is either
Allow
or Deny
, along with a list of the policies that resulted in the decision.
At this time, Verified Permissions accepts tokens from only Amazon Cognito.
Verified Permissions validates each token that is specified in a request by checking its expiration date and its signature.
Tokens from an identity source user continue to be usable until they expire. Token revocation and resource deletion have no effect on the validity of a token in your policy store
isAuthorizedWithToken
in interface AmazonVerifiedPermissions
isAuthorizedWithTokenRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic ListIdentitySourcesResult listIdentitySources(ListIdentitySourcesRequest request)
Returns a paginated list of all of the identity sources defined in the specified policy store.
listIdentitySources
in interface AmazonVerifiedPermissions
listIdentitySourcesRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic ListPoliciesResult listPolicies(ListPoliciesRequest request)
Returns a paginated list of all policies stored in the specified policy store.
listPolicies
in interface AmazonVerifiedPermissions
listPoliciesRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic ListPolicyStoresResult listPolicyStores(ListPolicyStoresRequest request)
Returns a paginated list of all policy stores in the calling Amazon Web Services account.
listPolicyStores
in interface AmazonVerifiedPermissions
listPolicyStoresRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic ListPolicyTemplatesResult listPolicyTemplates(ListPolicyTemplatesRequest request)
Returns a paginated list of all policy templates in the specified policy store.
listPolicyTemplates
in interface AmazonVerifiedPermissions
listPolicyTemplatesRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic PutSchemaResult putSchema(PutSchemaRequest request)
Creates or updates the policy schema in the specified policy store. The schema is used to validate any Cedar policies and policy templates submitted to the policy store. Any changes to the schema validate only policies and templates submitted after the schema change. Existing policies and templates are not re-evaluated against the changed schema. If you later update a policy, then it is evaluated against the new schema at that time.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
putSchema
in interface AmazonVerifiedPermissions
putSchemaRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ServiceQuotaExceededException
- The request failed because it would cause a service quota to be exceeded.ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic UpdateIdentitySourceResult updateIdentitySource(UpdateIdentitySourceRequest request)
Updates the specified identity source to use a new identity provider (IdP), or to change the mapping of identities from the IdP to a different principal entity type.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
updateIdentitySource
in interface AmazonVerifiedPermissions
updateIdentitySourceRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic UpdatePolicyResult updatePolicy(UpdatePolicyRequest request)
Modifies a Cedar static policy in the specified policy store. You can change only certain elements of the UpdatePolicyDefinition parameter. You can directly update only static policies. To change a template-linked policy, you must update the template instead, using UpdatePolicyTemplate.
If policy validation is enabled in the policy store, then updating a static policy causes Verified Permissions to validate the policy against the schema in the policy store. If the updated static policy doesn't pass validation, the operation fails and the update isn't stored.
When you edit a static policy, you can change only certain elements of a static policy:
The action referenced by the policy.
A condition clause, such as when and unless.
You can't change these elements of a static policy:
Changing a policy from a static policy to a template-linked policy.
Changing the effect of a static policy from permit or forbid.
The principal referenced by a static policy.
The resource referenced by a static policy.
To update a template-linked policy, you must update the template instead.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
updatePolicy
in interface AmazonVerifiedPermissions
updatePolicyRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ServiceQuotaExceededException
- The request failed because it would cause a service quota to be exceeded.ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic UpdatePolicyStoreResult updatePolicyStore(UpdatePolicyStoreRequest request)
Modifies the validation setting for a policy store.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
updatePolicyStore
in interface AmazonVerifiedPermissions
updatePolicyStoreRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic UpdatePolicyTemplateResult updatePolicyTemplate(UpdatePolicyTemplateRequest request)
Updates the specified policy template. You can update only the description and the some elements of the policyBody.
Changes you make to the policy template content are immediately (within the constraints of eventual consistency) reflected in authorization decisions that involve all template-linked policies instantiated from this template.
Verified Permissions is eventually consistent . It can take a few seconds for a new or changed element to propagate through the service and be visible in the results of other Verified Permissions operations.
updatePolicyTemplate
in interface AmazonVerifiedPermissions
updatePolicyTemplateRequest
- ValidationException
- The request failed because one or more input parameters don't satisfy their constraint requirements. The
output is provided as a list of fields and a reason for each field that isn't valid.
The possible reasons include the following:
UnrecognizedEntityType
The policy includes an entity type that isn't found in the schema.
UnrecognizedActionId
The policy includes an action id that isn't found in the schema.
InvalidActionApplication
The policy includes an action that, according to the schema, doesn't support the specified principal and resource.
UnexpectedType
The policy included an operand that isn't a valid type for the specified operation.
IncompatibleTypes
The types of elements included in a set
, or the types of expressions used in an
if...then...else
clause aren't compatible in this context.
MissingAttribute
The policy attempts to access a record or entity attribute that isn't specified in the schema. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
UnsafeOptionalAttributeAccess
The policy attempts to access a record or entity attribute that is optional and isn't guaranteed to be present. Test for the existence of the attribute first before attempting to access its value. For more information, see the has (presence of attribute test) operator in the Cedar Policy Language Guide.
ImpossiblePolicy
Cedar has determined that a policy condition always evaluates to false. If the policy is always false, it can never apply to any query, and so it can never affect an authorization decision.
WrongNumberArguments
The policy references an extension type with the wrong number of arguments.
FunctionArgumentValidationError
Cedar couldn't parse the argument passed to an extension type. For example, a string that is to be parsed as an IPv4 address can contain only digits and the period character.
ConflictException
- The request failed because another request to modify a resource occurred at the same.AccessDeniedException
- You don't have sufficient access to perform this action.ResourceNotFoundException
- The request failed because it references a resource that doesn't exist.ThrottlingException
- The request failed because it exceeded a throttling quota.InternalServerException
- The request failed because of an internal error. Try your request again laterpublic ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata
in interface AmazonVerifiedPermissions
request
- The originally executed requestpublic void shutdown()
AmazonWebServiceClient
shutdown
in interface AmazonVerifiedPermissions
shutdown
in class AmazonWebServiceClient