Actions, resources, and condition keys for AWS Snowball
AWS Snowball (service prefix: snowball
) provides the following service-specific resources, actions, and condition context keys for use in IAM permission policies.
References:
-
Learn how to configure this service.
-
View a list of the API operations available for this service.
-
Learn how to secure this service and its resources by using IAM permission policies.
Topics
Actions defined by AWS Snowball
You can specify the following actions in the Action
element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.
The Resource types column of the Actions table indicates whether each action supports resource-level permissions. If there is no value for this column, you must specify all resources ("*") to which the policy applies in the Resource
element of your policy statement. If the column includes a resource type, then you can specify an ARN of that type in a statement with that action. If the action has one or more required resources, the caller must have permission to use the action with those resources. Required resources are indicated in the table with an asterisk (*). If you limit resource access with the Resource
element in an IAM policy, you must include an ARN or pattern for each required resource type. Some actions support multiple resource types. If the resource type is optional (not indicated as required), then you can choose to use one of the optional resource types.
The Condition keys column of the Actions table includes keys that you can specify in a policy statement's Condition
element. For more information on the condition keys that are associated with resources for the service, see the Condition keys column of the Resource types table.
Note
Resource condition keys are listed in the Resource types table. You can find a link to the resource type that applies to an action in the Resource types (*required) column of the Actions table. The resource type in the Resource types table includes the Condition keys column, which are the resource condition keys that apply to an action in the Actions table.
For details about the columns in the following table, see Actions table.
Actions | Description | Access level | Resource types (*required) | Condition keys | Dependent actions |
---|---|---|---|---|---|
CancelCluster | Grants permission to cancel a cluster job | Write | |||
CancelJob | Grants permission to cancel the specified job | Write | |||
CreateAddress | Grants permission to create an address for a Snowball to be shipped to | Write | |||
CreateCluster | Grants permission to create an empty cluster | Write | |||
CreateJob | Grants permission to creates a job to import or export data between Amazon S3 and your on-premises data center | Write | |||
CreateLongTermPricing | Grants permission to creates a LongTermPricingListEntry for allowing customers to add an upfront billing contract for a job | Write | |||
CreateReturnShippingLabel | Grants permission to create a shipping label that will be used to return the Snow device to AWS | Write | |||
DescribeAddress | Grants permission to get specific details about that address in the form of an Address object | Read | |||
DescribeAddresses | Grants permission to describe a specified number of ADDRESS objects | List | |||
DescribeCluster | Grants permission to describe information about a specific cluster including shipping information, cluster status, and other important metadata | Read | |||
DescribeJob | Grants permission to describe information about a specific job including shipping information, job status, and other important metadata | Read | |||
DescribeReturnShippingLabel | Grants permission to describe information on the shipping label of a Snow device that is being returned to AWS | Read | |||
GetJobManifest | Grants permission to get a link to an Amazon S3 presigned URL for the manifest file associated with the specified JobId value | Read | |||
GetJobUnlockCode | Grants permission to get the UnlockCode code value for the specified job | Read | |||
GetSnowballUsage | Grants permission to get information about the Snowball service limit for your account, and also the number of Snowballs your account has in use | Read | |||
GetSoftwareUpdates | Grants permission to return an Amazon S3 presigned URL for an update file associated with a specified JobId | Read | |||
ListClusterJobs | Grants permission to list JobListEntry objects of the specified length | List | |||
ListClusters | Grants permission to list ClusterListEntry objects of the specified length | List | |||
ListCompatibleImages | Grants permission to return a list of the different Amazon EC2 Amazon Machine Images (AMIs) that are owned by your AWS account that would be supported for use on a Snow device | List | |||
ListJobs | Grants permission to list JobListEntry objects of the specified length | List | |||
ListLongTermPricing | Grants permission to list LongTermPricingListEntry objects for the account making the request | Read | |||
ListPickupLocations | Grants permission to list Address objects where pickup is available, of the specified length | List | |||
ListServiceVersions | Grants permission to list all supported versions for Snow on-device services | List | |||
UpdateCluster | Grants permission to update while a cluster's ClusterState value is in the AwaitingQuorum state, you can update some of the information associated with a cluster | Write | |||
UpdateJob | Grants permission to update while a job's JobState value is New, you can update some of the information associated with a job | Write | |||
UpdateJobShipmentState | Grants permission to update the state when a the shipment states changes to a different state | Write | |||
UpdateLongTermPricing | Grants permission to update a specific upfront billing contract for a job | Write |
Resource types defined by AWS Snowball
AWS Snowball does not support specifying a resource ARN in the Resource
element of an IAM policy statement. To allow access to AWS Snowball, specify "Resource": "*"
in your policy.
Condition keys for AWS Snowball
Snowball has no service-specific context keys that can be used in the Condition
element of policy statements. For the list of the global context keys that are available to all services, see Available keys for conditions.