Actions Supported by Identity Policy-based Authorization

IAM provides system-defined identity policies to define common actions supported by cloud services. You can also create custom identity policies using the actions supported by cloud services for more refined access control.

In addition to IAM, the Organizations service also provides Service Control Policies (SCPs) to set access control policies.

SCPs do not actually grant any permissions to a principal. They only set the permissions boundary for the principal. When SCPs are attached to a member account or an organizational unit (OU), the SCPs do not directly grant permissions to that member account or OU. Instead, the SCPs just determine what permissions are available for that member account or the member accounts under that OU. The granted permissions can be applied only if they are allowed by the SCPs.

To learn more about how IAM is different from Organizations for access control, see What Are the Differences in Access Control Between IAM and Organizations?

This section describes the elements used by IAM custom identity policies and Organizations SCPs. The elements include actions, resources, and conditions.

For details about how to use these elements to create an IAM custom identity policy, see Creating a Custom Identity Policy.
For details about how to use these elements to create a custom SCP, see Creating an SCP.

Action

Actions are specific operations that are allowed or denied in an identity policy.

The Access Level column describes how the action is classified (List, Read, or Write). This classification helps you understand the level of access that an action grants when you use it in an identity policy.
The Resource Type column indicates whether the action supports resource-level permissions.
- You can use a wildcard (*) to indicate all resource types. If this column is empty (-), the action does not support resource-level permissions and you must specify all resources ("*") in your identity policy statements.
- If this column includes a resource type, you must specify the URN in the Resource element of your statements.
- Required resources are marked with asterisks (*) in the table. If you specify a resource in a statement using this action, then it must be of this type.
For details about the resource types defined by SWR, see Resource.
The Condition Key column contains keys that you can specify in the Condition element of an identity policy statement.
- If the Resource Type column has values for an action, the condition key takes effect only for the listed resource types.
- If the Resource Type column is empty (-) for an action, the condition key takes effect for all resources that action supports.
- If the Condition Key column is empty (-) for an action, the action does not support any condition keys.
For details about the condition keys defined by SWR, see Conditions.
The Alias column lists the policy actions that are configured in identity policies. With these actions, you can use APIs for policy-based authorization. For details, see Policies and Identity Policies.

The following table lists the actions that you can define in identity policy statements for SWR.

**Table 1** Actions supported by SWR
Action	Description	Access Level	Resource (*: required)	Condition Key	Alias
swr:namespace:createNamespace	(Basic Edition) Grants permission to create an organization.	Write	namespace *	-	-
swr:namespace:deleteNamespace	(Basic Edition) Grants permission to delete an organization.	Write	namespace *	-	-
swr:namespace:listNamespaces	(Basic Edition) Grants permission to list organizations.	List	namespace *	-	-
swr:namespace:getNamespace	(Basic Edition) Grants permission to query details about an organization.	Read	namespace *	-	-
swr:repo:createRepo	(Basic Edition) Grants permission to create a repository.	Write	repo *	-	-
swr:repo:createRepo	(Basic Edition) Grants permission to create a repository.	Write	-	swr:AllowPublicAccess	-
swr:repo:deleteRepo	(Basic Edition) Grants permission to delete a repository.	Write	repo *	-	-
swr:repo:listRepos	(Basic Edition) Grants permission to list repositories.	List	repo *	-	-
swr:repo:listSharedRepos	(Basic Edition) Grants permission to list shared images.	List	repo *	-	-
swr:repo:getRepo	(Basic Edition) Grants permission to query brief information about a repository.	Read	repo *	-	-
swr:repo:updateRepo	(Basic Edition) Grants permission to update brief information about a repository.	Write	repo *	-	-
swr:repo:updateRepo		Write	-	swr:AllowPublicAccess	-
swr:repo:deleteRepoTag	(Basic Edition) Grants permission to delete images with specified tags.	Write	repo *	-	-
swr:repo:createRepoTag	(Basic Edition) Grants permission to create an image tag.	Write	repo *	-	-
swr:repo:listRepoTags	(Basic Edition) Grants permission to list image tags.	List	repo *	-	-
swr:repo:createRepoDomain	(Basic Edition) Grants permission to share images with other accounts.	Permission_management	repo *	-	-
swr:repo:createRepoDomain		Permission_management	-	swr:TargetAccountId swr:TargetOrgPath swr:TargetOrgId	-
swr:repo:deleteRepoDomain	(Basic Edition) Grants permission to delete accounts from an image sharing list.	Permission_management	repo *	-	-
swr:repo:listRepoDomains	(Basic Edition) Grants permission to list accounts an image is shared with.	List	repo *	-	-
swr:repo:getRepoDomain	(Basic Edition) Grants permission to check whether images are shared with an account.	Read	repo *	-	-
swr:repo:updateRepoDomain	(Basic Edition) Grants permission to update an account images are shared with.	Permission_management	repo *	-	-
swr:repo:createRepoShare	(Basic Edition) Grants permission to create an image sharing policy.	Permission_management	repo *	-	-
swr:repo:createRepoShare		Permission_management	-	swr:TargetAccountId swr:TargetOrgPath swr:TargetOrgId	-
swr:repo:deleteRepoShare	(Basic Edition) Grants permission to delete an image sharing policy.	Permission_management	repo *	-	-
swr:repo:listRepoShares	(Basic Edition) Grants permission to list image sharing policies.	List	repo *	-	-
swr:repo:getRepoShare	(Basic Edition) Grants permission to query details about an image sharing policy.	Read	repo *	-	-
swr:repo:updateRepoShare	(Basic Edition) Grants permission to update an image sharing policy.	Permission_management	repo *	-	-
swr:repo:createAutoSyncRepoJob	(Basic Edition) Grants permission to create an automatic image synchronization task.	Write	repo *	-	-
swr:repo:createAutoSyncRepoJob		Write	-	swr:TargetRegion	-
swr:repo:createManualSyncRepoJob	(Basic Edition) Grants permission to manually synchronize images.	Write	repo *	-	-
swr:repo:createManualSyncRepoJob		Write	-	swr:TargetRegion	-
swr:repo:deleteAutoSyncRepoJob	(Basic Edition) Grants permission to delete an automatic image synchronization task.	Write	repo *	-	-
swr:repo:listAutoSyncRepoJobs	(Basic Edition) Grants permission to list automatic image synchronization tasks.	List	repo *	-	-
swr:repo:getSyncRepoJobInfo	(Basic Edition) Grants permission to query details about an image synchronization task.	Read	repo *	-	-
swr:repo:createTrigger	(Basic Edition) Grants permission to create a trigger.	Write	repo *	-	-
swr:repo:deleteTrigger	(Basic Edition) Grants permission to delete a trigger.	Write	repo *	-	-
swr:repo:listTriggers	(Basic Edition) Grants permission to list triggers.	List	repo *	-	-
swr:repo:getTrigger	(Basic Edition) Grants permission to query details about a trigger.	Read	repo *	-	-
swr:repo:updateTrigger	(Basic Edition) Grants permission to update a trigger.	Write	repo *	-	-
swr:repo:createRetention	(Basic Edition) Grants permission to create an image retention policy.	Write	repo *	-	-
swr:repo:deleteRetention	(Basic Edition) Grants permission to delete an image retention policy.	Write	repo *	-	-
swr:repo:listRetentionHistories	(Basic Edition) Grants permission to list image retention records.	List	repo *	-	-
swr:repo:listRetentions	(Basic Edition) Grants permission to list image retention policies.	List	repo *	-	-
swr:repo:getRetention	(Basic Edition) Grants permission to query details about an image retention policy record.	Read	repo *	-	-
swr:repo:updateRetention	(Basic Edition) Grants permission to modify an image retention policy.	Write	repo *	-	-
swr::createLoginSecret	(Basic Edition) Grants permission to generate a temporary login command.	Write	-	-	-
swr::createAuthorizationToken	(Basic Edition) Grants permission to generate a new temporary login command.	Write	-	-	-
swr::listQuotas	(Basic Edition) Grants permission to list quotas.	List	-	-	-
swr::getDomainOverview	(Basic Edition) Grants permission to query brief resource information of a tenant.	Read	-	-	-
swr::getDomainResourceReports	(Basic Edition) Grants permission to query resource statistics of a tenant.	Read	-	-	-
swr:namespace:multipartUpload	(Basic Edition) Grants permission to upload an image in multipart mode.	Write	namespace *	-	-
swr:namespace:createNamespaceAccess	(Basic Edition) Grants permission to grant organization permissions.	Permission_management	namespace *	-	-
swr:namespace:deleteNamespaceAccess	(Basic Edition) Grants permission to cancel organization permissions.	Permission_management	namespace *	-	-
swr:namespace:getNamespaceAccess	(Basic Edition) Grants permission to query organization permissions.	Read	namespace *	-	-
swr:namespace:updateNamespaceAccess	(Basic Edition) Grants permission to update organization permissions.	Permission_management	namespace *	-	-
swr:repo:createRepoAccess	(Basic Edition) Grants permission to grant image permissions.	Permission_management	repo *	-	-
swr:repo:deleteRepoAccess	(Basic Edition) Grants permission to cancel image permissions.	Permission_management	repo *	-	-
swr:repo:getRepoAccess	(Basic Edition) Grants permission to query image permissions.	Read	repo *	-	-
swr:repo:updateRepoAccess	(Basic Edition) Grants permission to update image permissions.	Permission_management	repo *	-	-
swr:repo:upload	(Basic Edition) Grants permission to upload an image.	Write	repo *	-	-
swr:repo:upload	(Basic Edition) Grants permission to upload an image.	Write	-	swr:AllowCredentialType	-
swr:repo:download	(Basic Edition) Grants permission to download an image.	Read	repo *	swr:RepositoryIsPublic	-
swr:repo:download	(Basic Edition) Grants permission to download an image.	Read	-	swr:AllowCredentialType	-
swr:repo:getRepoTag	(Basic Edition) Grants permission to query images with specified tags.	Read	repo *	-	-

Each API of SWR usually supports one or more actions. Table 2 lists the supported actions and dependencies.

**Table 2** Actions and dependencies supported by APIs
API	Action	Dependency
-	swr:repo:upload	-
-	swr:repo:download	-
POST /v2/manage/namespaces	swr:namespace:createNamespace	-
DELETE /v2/manage/namespaces/{namespace}	swr:namespace:deleteNamespace	-
GET /v2/manage/namespaces	swr:namespace:listNamespaces	-
GET /v2/manage/namespaces/{namespace}	swr:namespace:getNamespace	-
POST /v2/manage/namespaces/{namespace}/repos	swr:repo:createRepo	-
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}	swr:repo:deleteRepo	-
GET /v2/manage/repos	swr:repo:listRepos	-
GET /v2/manage/shared-repositories	swr:repo:listSharedRepos	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}	swr:repo:getRepo	-
PATCH /v2/manage/namespaces/{namespace}/repos/{repository}	swr:repo:updateRepo	-
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/tags/{tag}	swr:repo:deleteRepoTag	-
POST /v2/manage/namespaces/{namespace}/repos/{repository}/tags	swr:repo:createRepoTag	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/tags	swr:repo:listRepoTags	-
POST /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains	swr:repo:createRepoDomain	-
DELETE /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain}	swr:repo:deleteRepoDomain	-
GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains	swr:repo:listRepoDomains	-
GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain}	swr:repo:getRepoDomain	-
PATCH /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain}	swr:repo:updateRepoDomain	-
POST /v2/manage/namespaces/{namespace}/repos/{repository}/shares	swr:repo:createRepoShare	-
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/shares/{share_id}	swr:repo:deleteRepoShare	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/shares	swr:repo:listRepoShares	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/shares/{share_id}	swr:repo:getRepoShare	-
PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/shares/{share_id}	swr:repo:updateRepoShare	-
POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo	swr:repo:createAutoSyncRepoJob	swr::createLoginSecret swr:repo:download swr:repo:upload
POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_images	swr:repo:createManualSyncRepoJob	swr::createLoginSecret swr:repo:download swr:repo:upload
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo	swr:repo:deleteAutoSyncRepoJob	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo	swr:repo:listAutoSyncRepoJobs	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_job	swr:repo:getSyncRepoJobInfo	-
POST /v2/manage/namespaces/{namespace}/repos/{repository}/triggers	swr:repo:createTrigger	-
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}	swr:repo:deleteTrigger	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers	swr:repo:listTriggers	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}	swr:repo:getTrigger	-
PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}	swr:repo:updateTrigger	-
POST /v2/manage/namespaces/{namespace}/repos/{repository}/retentions	swr:repo:createRetention	-
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}	swr:repo:deleteRetention	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories	swr:repo:listRetentionHistories	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions	swr:repo:listRetentions	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}	swr:repo:getRetention	-
PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id}	swr:repo:updateRetention	-
POST /v2/manage/utils/secret	swr::createLoginSecret	-
POST /v2/manage/utils/authorizationtoken	swr::createAuthorizationToken	sts::createServiceBearerToken
GET /v2/manage/projects/{project_id}/quotas	swr::listQuotas	-
GET /v2/manage/overview	swr::getDomainOverview	-
GET /v2/manage/reports/{resource_type}/{frequency}	swr::getDomainResourceReports	-
-	swr:namespace:multipartUpload	-
POST /v2/manage/namespaces/{namespace}/access	swr:namespace:createNamespaceAccess	-
DELETE /v2/manage/namespaces/{namespace}/access	swr:namespace:deleteNamespaceAccess	-
GET /v2/manage/namespaces/{namespace}/access	swr:namespace:getNamespaceAccess	-
PATCH /v2/manage/namespaces/{namespace}/access	swr:namespace:updateNamespaceAccess	-
POST /v2/manage/namespaces/{namespace}/repos/{repository}/access	swr:repo:createRepoAccess	-
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/access	swr:repo:deleteRepoAccess	-
GET /v2/manage/namespaces/{namespace}/repos/{repository}/access	swr:repo:getRepoAccess	-
PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/access	swr:repo:updateRepoAccess	-
-	swr:repo:getRepoTag	-
-	swr:repo:listRepoTags	-
-	swr:repo:listSharedRepos	-
-	swr:repo:listRepos	-

Resource

A resource type indicates the resource to which a policy applies to. If you specify a resource type for any action in Table 3, a resource URN must be specified in the identity policy statements using that action, and the identity policy applies only to the resource. If no resource type is specified, the Resource element is marked with an asterisk (*) and the identity policy applies to all resources. You can also set condition keys in an identity policy to define resource types.

The following table lists the resource types that you can specify in identity policy statements for SWR.

**Table 3** Resource types supported by SWR
Resource	URN
repo	swr:<region>:<account-id>:repo:<namespace-name>/<repo-name>
namespace	swr:<region>:<account-id>:namespace:<namespace-name>

Conditions

Condition Key

A Condition element lets you specify conditions for when an identity policy is in effect. It contains condition keys and operators.

The condition key that you specify They are classified into global condition keys and service-specific condition keys based on the application scope.
- Global condition keys (with the g: prefix) apply to all actions. Cloud services do not need to provide user identity information. Instead, the system automatically obtains such information and authenticates users. For details, see Global Condition Keys.
- Service-specific condition keys (with the abbreviation of a service name plus a colon as the prefix, for example, swr:) only apply to operations of the SWR service. For details, see Table 4.
- The number of values associated with a condition key in the request context of an API call makes the condition key single-valued or multivalued. Single-valued condition keys have at most one value in the request context of an API call. Multivalued condition keys can have multiple values in the request context of an API call. For example, a request can originate from at most one VPC endpoint, so g:SourceVpce is a single-valued condition key. You can tag resources and include multiple tag key-value pairs in a request, so g:TagKeys is a multivalued condition key.
A condition operator, condition key, and a condition value together constitute a complete condition statement. An identity policy can be applied only when its request conditions are met. For supported condition operators, see Condition operators.

Service-specific condition keys supported by SWR

The following table lists the condition keys that you can define in identity policies for SWR. You can include these condition keys to specify conditions for when your identity policy is in effect.

**Table 4** Service-specific condition keys supported by SWR
Service-specific Condition Key	Type	Single-valued/Multivalued	Description
swr:TargetOrgPath	string	Single-valued	Controls permissions of target sharing accounts based on their organization paths.
swr:TargetOrgId	string	Single-valued	Controls permissions of target sharing accounts based on their organization IDs.
swr:TargetAccountId	string	Single-valued	Controls permissions of target sharing accounts based on their IDs.
swr:AllowPublicAccess	boolean	Single-valued	Controls whether images can be public.
swr:TargetRegion	string	Single-valued	Controls permissions based on destination regions.
swr:AllowCredentialType	string	Single-valued	Controls permissions based on the login command type (long-term login command or temporary login command).
swr:RepositoryIsPublic	boolean	Single-valued	Controls permissions based on whether the images are public.