S3 Access Grants에 AWS 태그 사용 - Amazon Simple Storage Service

S3 Access Grants에 AWS 태그 사용

Amazon S3 Access Grants의 태그는 Amazon S3의 객체 태그와 유사한 특성을 가지고 있습니다. 각 태그는 키-값 페어입니다. 태그를 지정할 수 있는 S3 Access Grants의 리소스는 S3 Access Grants 인스턴스, 위치 및 권한 부여입니다.

참고

S3 Access Grants에서는 태그 지정에 객체 태그 지정과는 다른 API 작업을 사용합니다. S3 Access Grants는 TagResource, UntagResource 및 ListTagsForResource API 작업을 사용하며, 리소스는 S3 Access Grants 인스턴스, 등록된 위치 또는 액세스 권한 부여일 수 있습니다.

객체 태그와 마찬가지로 다음과 같은 제한이 적용됩니다.

  • S3 Access Grants 리소스를 만들 때 새로운 리소스에 태그를 추가하거나 기존 리소스에 태그를 추가할 수 있습니다.

  • 한 리소스에 태그를 최대 10개까지 연결할 수 있습니다. 여러 태그가 동일한 리소스에 연결된 경우 고유한 태그 키가 있어야 합니다.

  • 태그 키의 최대 길이는 128개 유니코드 문자이며, 태그 값의 최대 길이는 256개 유니코드 문자입니다. 태그는 내부적으로 UTF-16 형식으로 표시됩니다. UTF-16에서 문자는 1 또는 2자 위치를 차지합니다.

  • 키와 값은 대/소문자를 구분합니다.

태그 제한에 대한 자세한 내용은 AWS Billing 사용 설명서의 사용자 정의 태그 제한을 참조하세요.

AWS Command Line Interface(AWS CLI), Amazon S3 REST API 또는 AWS SDK를 사용하여 S3 Access Grants의 리소스에 태그를 지정할 수 있습니다.

AWS CLI를 설치하려면 AWS Command Line Interface 사용 설명서의 AWS CLI 설치를 참조하세요.

S3 Access Grants 리소스를 생성할 때 또는 생성한 후에 리소스에 태그를 지정할 수 있습니다. 다음 예시는 S3 Access Grants 인스턴스에 태그를 지정하거나 태그를 해제하는 방법을 보여줍니다. 등록된 위치 및 액세스 권한 부여에도 유사한 작업을 수행할 수 있습니다.

다음 예시 명령을 사용하려면 user input placeholders를 실제 정보로 대체하세요.

예 - 태그를 지정하여 S3 Access Grants 인스턴스 생성
aws s3control create-access-grants-instance \
 --account-id 111122223333 \
 --profile access-grants-profile \
 --region us-east-2 \
 --tags Key=tagKey1,Value=tagValue1

응답:

 {
    "CreatedAt": "2023-10-25T01:09:46.719000+00:00",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}
예 - 이미 생성된 S3 Access Grants 인스턴스에 태그 지정
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey2,Value=tagValue2
예 - S3 Access Grants 인스턴스의 태그 나열
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2

응답:

{
    "Tags": [
        {
            "Key": "tagKey1",
            "Value": "tagValue1"
        },
        {
            "Key": "tagKey2",
            "Value": "tagValue2"
        }
    ]
}
예 - S3 Access Grants 인스턴스의 태그 해제
aws s3control untag-resource \
 --account-id 111122223333 \
 --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
 --profile access-grants-profile \
 --region us-east-2 \
 --tag-keys "tagKey2"

Amazon S3 API를 사용하여 S3 Access Grants 인스턴스, 등록된 위치 또는 액세스 권한 부여에 태그를 지정하거나 해제하거나 나열할 수 있습니다. S3 Access Grants 태그 관리를 위한 REST API 지원에 대한 자세한 내용은 Amazon Simple Storage Service API 참조의 다음 섹션을 참조하세요.