cdk-iam-floyd
Version:
AWS IAM policy statement generator with fluent interface for AWS CDK
562 lines (561 loc) • 20.2 kB
TypeScript
import { AccessLevelList } from '../../shared/access-level';
import { PolicyStatement, Operator } from '../../shared';
import { aws_iam as iam } from "aws-cdk-lib";
/**
* Statement provider for service [ecr](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerregistry.html).
*
* @param sid [SID](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_sid.html) of the statement
*/
export declare class Ecr extends PolicyStatement {
servicePrefix: string;
/**
* Grants permission to check the availability of multiple image layers in a specified registry and repository
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_BatchCheckLayerAvailability.html
*/
toBatchCheckLayerAvailability(): this;
/**
* Grants permission to delete a list of specified images within a specified repository
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_BatchDeleteImage.html
*/
toBatchDeleteImage(): this;
/**
* Grants permission to get detailed information for specified images within a specified repository
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_BatchGetImage.html
*/
toBatchGetImage(): this;
/**
* Grants permission to retrieve repository scanning configuration for a list of repositories
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_BatchGetRepositoryScanningConfiguration.html
*/
toBatchGetRepositoryScanningConfiguration(): this;
/**
* Grants permission to retrieve the image from the upstream registry and import it to your private registry
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/userguide/pull-through-cache.html
*/
toBatchImportUpstreamImage(): this;
/**
* Grants permission to inform Amazon ECR that the image layer upload for a specified registry, repository name, and upload ID, has completed
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_CompleteLayerUpload.html
*/
toCompleteLayerUpload(): this;
/**
* Grants permission to create new pull-through cache rule
*
* Access Level: Write
*
* Dependent actions:
* - iam:CreateServiceLinkedRole
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_CreatePullThroughCacheRule.html
*/
toCreatePullThroughCacheRule(): this;
/**
* Grants permission to create an image repository
*
* Access Level: Write
*
* Possible conditions:
* - .ifAwsRequestTag()
* - .ifAwsTagKeys()
*
* Dependent actions:
* - ecr:TagResource
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_CreateRepository.html
*/
toCreateRepository(): this;
/**
* Grants permission to create the repository creation template
*
* Access Level: Write
*
* Dependent actions:
* - ecr:CreateRepository
* - ecr:PutLifecyclePolicy
* - ecr:SetRepositoryPolicy
* - iam:CreateServiceLinkedRole
* - iam:PassRole
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_CreateRepositoryCreationTemplate.html
*/
toCreateRepositoryCreationTemplate(): this;
/**
* Grants permission to delete the specified lifecycle policy
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DeleteLifecyclePolicy.html
*/
toDeleteLifecyclePolicy(): this;
/**
* Grants permission to delete the pull-through cache rule
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DeletePullThroughCacheRule.html
*/
toDeletePullThroughCacheRule(): this;
/**
* Grants permission to delete the registry policy
*
* Access Level: Permissions management
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DeleteRegistryPolicy.html
*/
toDeleteRegistryPolicy(): this;
/**
* Grants permission to delete an existing image repository
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DeleteRepository.html
*/
toDeleteRepository(): this;
/**
* Grants permission to delete the repository creation template
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DeleteRepositoryCreationTemplate.html
*/
toDeleteRepositoryCreationTemplate(): this;
/**
* Grants permission to delete the repository policy from a specified repository
*
* Access Level: Permissions management
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DeleteRepositoryPolicy.html
*/
toDeleteRepositoryPolicy(): this;
/**
* Grants permission to retrieve replication status about an image in a registry, including failure reason if replication fails
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DescribeImageReplicationStatus.html
*/
toDescribeImageReplicationStatus(): this;
/**
* Grants permission to describe the image scan findings for the specified image
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DescribeImageScanFindings.html
*/
toDescribeImageScanFindings(): this;
/**
* Grants permission to get metadata about the images in a repository, including image size, image tags, and creation date
*
* Access Level: List
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DescribeImages.html
*/
toDescribeImages(): this;
/**
* Grants permission to describe the pull-through cache rules
*
* Access Level: List
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DescribePullThroughCacheRules.html
*/
toDescribePullThroughCacheRules(): this;
/**
* Grants permission to describe the registry settings
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DescribeRegistry.html
*/
toDescribeRegistry(): this;
/**
* Grants permission to describe image repositories in a registry
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DescribeRepositories.html
*/
toDescribeRepositories(): this;
/**
* Grants permission to describe the repository creation template
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_DescribeRepositoryCreationTemplates.html
*/
toDescribeRepositoryCreationTemplates(): this;
/**
* Grants permission to retrieve account settings
*
* Access Level: Read
*
* Possible conditions:
* - .ifAccountSetting()
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetAccountSetting.html
*/
toGetAccountSetting(): this;
/**
* Grants permission to retrieve a token that is valid for a specified registry for 12 hours
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetAuthorizationToken.html
*/
toGetAuthorizationToken(): this;
/**
* Grants permission to retrieve the download URL corresponding to an image layer
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetDownloadUrlForLayer.html
*/
toGetDownloadUrlForLayer(): this;
/**
* Grants permission to retrieve the status about an image copy
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/userguide/pull-through-cache.html
*/
toGetImageCopyStatus(): this;
/**
* Grants permission to retrieve the specified lifecycle policy
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetLifecyclePolicy.html
*/
toGetLifecyclePolicy(): this;
/**
* Grants permission to retrieve the results of the specified lifecycle policy preview request
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetLifecyclePolicyPreview.html
*/
toGetLifecyclePolicyPreview(): this;
/**
* Grants permission to retrieve the registry policy
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetRegistryPolicy.html
*/
toGetRegistryPolicy(): this;
/**
* Grants permission to retrieve registry scanning configuration
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetRegistryScanningConfiguration.html
*/
toGetRegistryScanningConfiguration(): this;
/**
* Grants permission to retrieve the repository policy for a specified repository
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_GetRepositoryPolicy.html
*/
toGetRepositoryPolicy(): this;
/**
* Grants permission to notify Amazon ECR that you intend to upload an image layer
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_InitiateLayerUpload.html
*/
toInitiateLayerUpload(): this;
/**
* Grants permission to list all the image IDs for a given repository
*
* Access Level: List
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_ListImages.html
*/
toListImages(): this;
/**
* Grants permission to list the tags for an Amazon ECR resource
*
* Access Level: Read
*
* Possible conditions:
* - .ifAwsRequestTag()
* - .ifAwsTagKeys()
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_ListTagsForResource.html
*/
toListTagsForResource(): this;
/**
* Grants permission to update account settings
*
* Access Level: Write
*
* Possible conditions:
* - .ifAccountSetting()
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutAccountSetting.html
*/
toPutAccountSetting(): this;
/**
* Grants permission to create or update the image manifest associated with an image
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutImage.html
*/
toPutImage(): this;
/**
* Grants permission to update the image scanning configuration for a repository
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutImageScanningConfiguration.html
*/
toPutImageScanningConfiguration(): this;
/**
* Grants permission to update the image tag mutability settings for a repository
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutImageTagMutability.html
*/
toPutImageTagMutability(): this;
/**
* Grants permission to create or update a lifecycle policy
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutLifecyclePolicy.html
*/
toPutLifecyclePolicy(): this;
/**
* Grants permission to update the registry policy
*
* Access Level: Permissions management
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutRegistryPolicy.html
*/
toPutRegistryPolicy(): this;
/**
* Grants permission to update registry scanning configuration
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutRegistryScanningConfiguration.html
*/
toPutRegistryScanningConfiguration(): this;
/**
* Grants permission to update the replication configuration for the registry
*
* Access Level: Write
*
* Dependent actions:
* - iam:CreateServiceLinkedRole
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_PutReplicationConfiguration.html
*/
toPutReplicationConfiguration(): this;
/**
* Grants permission to replicate images to the destination registry
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry-permissions.html
*/
toReplicateImage(): this;
/**
* Grants permission to apply a repository policy on a specified repository to control access permissions
*
* Access Level: Permissions management
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_SetRepositoryPolicy.html
*/
toSetRepositoryPolicy(): this;
/**
* Grants permission to start an image scan
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_StartImageScan.html
*/
toStartImageScan(): this;
/**
* Grants permission to start a preview of the specified lifecycle policy
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_StartLifecyclePolicyPreview.html
*/
toStartLifecyclePolicyPreview(): this;
/**
* Grants permission to tag an Amazon ECR resource
*
* Access Level: Tagging
*
* Possible conditions:
* - .ifAwsRequestTag()
* - .ifAwsTagKeys()
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_TagResource.html
*/
toTagResource(): this;
/**
* Grants permission to untag an Amazon ECR resource
*
* Access Level: Tagging
*
* Possible conditions:
* - .ifAwsTagKeys()
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_UntagResource.html
*/
toUntagResource(): this;
/**
* Grants permission to update the pull-through cache rule
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_UpdatePullThroughCacheRule.html
*/
toUpdatePullThroughCacheRule(): this;
/**
* Grants permission to update the repository creation template
*
* Access Level: Write
*
* Dependent actions:
* - ecr:CreateRepository
* - ecr:PutLifecyclePolicy
* - ecr:SetRepositoryPolicy
* - iam:CreateServiceLinkedRole
* - iam:PassRole
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_UpdateRepositoryCreationTemplate.html
*/
toUpdateRepositoryCreationTemplate(): this;
/**
* Grants permission to upload an image layer part to Amazon ECR
*
* Access Level: Write
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_UploadLayerPart.html
*/
toUploadLayerPart(): this;
/**
* Grants permission to validate the pull-through cache rule
*
* Access Level: Read
*
* https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_ValidatePullThroughCacheRule.html
*/
toValidatePullThroughCacheRule(): this;
protected accessLevelList: AccessLevelList;
/**
* Adds a resource of type repository to the statement
*
* https://docs.aws.amazon.com/AmazonECR/latest/userguide/Repositories.html
*
* @param repositoryName - Identifier for the repositoryName.
* @param account - Account of the resource; defaults to `*`, unless using the CDK, where the default is the current Stack's account.
* @param region - Region of the resource; defaults to `*`, unless using the CDK, where the default is the current Stack's region.
* @param partition - Partition of the AWS account [aws, aws-cn, aws-us-gov]; defaults to `aws`, unless using the CDK, where the default is the current Stack's partition.
*
* Possible conditions:
* - .ifAwsResourceTag()
* - .ifResourceTag()
*/
onRepository(repositoryName: string, account?: string, region?: string, partition?: string): this;
/**
* Filters access by the allowed set of values for each of the tags
*
* https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag
*
* Applies to actions:
* - .toCreateRepository()
* - .toListTagsForResource()
* - .toTagResource()
*
* @param tagKey The tag key to check
* @param value The value(s) to check
* @param operator Works with [string operators](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String). **Default:** `StringLike`
*/
ifAwsRequestTag(tagKey: string, value: string | string[], operator?: Operator | string): this;
/**
* Filters access by tag-value associated with the resource
*
* https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag
*
* Applies to resource types:
* - repository
*
* @param tagKey The tag key to check
* @param value The value(s) to check
* @param operator Works with [string operators](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String). **Default:** `StringLike`
*/
ifAwsResourceTag(tagKey: string, value: string | string[], operator?: Operator | string): this;
/**
* Filters access by the presence of mandatory tags in the request
*
* https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys
*
* Applies to actions:
* - .toCreateRepository()
* - .toListTagsForResource()
* - .toTagResource()
* - .toUntagResource()
*
* @param value The value(s) to check
* @param operator Works with [string operators](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String). **Default:** `StringLike`
*/
ifAwsTagKeys(value: string | string[], operator?: Operator | string): this;
/**
* Filters access by the ECR account setting name
*
* https://docs.aws.amazon.com/AmazonECR/latest/userguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-conditionkeys
*
* Applies to actions:
* - .toGetAccountSetting()
* - .toPutAccountSetting()
*
* @param value The value(s) to check
* @param operator Works with [string operators](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String). **Default:** `StringLike`
*/
ifAccountSetting(value: string | string[], operator?: Operator | string): this;
/**
* Filters access by tag-value associated with the resource
*
* https://docs.aws.amazon.com/AmazonECR/latest/userguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-conditionkeys
*
* Applies to resource types:
* - repository
*
* @param tagKey The tag key to check
* @param value The value(s) to check
* @param operator Works with [string operators](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html#Conditions_String). **Default:** `StringLike`
*/
ifResourceTag(tagKey: string, value: string | string[], operator?: Operator | string): this;
/**
* Statement provider for service [ecr](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticcontainerregistry.html).
*
*/
constructor(props?: iam.PolicyStatementProps);
}