SYSTEM$GET_CMK_INFO

SYSTEM$GET_CMK_INFO

Tri-Secret Secure에서 사용할 고객 관리 키(CMK)의 상태를 돌려주는 시스템 함수예요. CMK 등록 상태와 프라이빗 연결 여부를 확인할 수 있어요.

출처: 공식 문서

본문

Tri-Secret Secure와 함께 사용할 고객 관리 키(CMK)의 상태를 반환합니다.

참고 (See also): CMK 자체 등록과 Tri-Secret Secure의 서포트 활성화 이해하기

구문 (Syntax)

SYSTEM$GET_CMK_INFO( [ '<ssa_account_name>' ] )

인자 (Arguments)

필수 (Required): 없음.

선택 (Optional):

ssa_account_name

CMK 상태를 검색하려는 SSA 계정의 이름을 지정하는 문자열입니다.

반환값 (Returns)

CMK의 상태를 나타내는 상태 메시지를 반환합니다. 출력에는 SYSTEM$REGISTER_CMK_INFO를 호출할 때 지정한 값이 포함됩니다. 프라이빗 연결을 활성화했다면, SYSTEM$GET_CMK_INFO가 반환하는 상태 메시지에는 CMK가 프라이빗으로 연결되었는지 여부가 포함됩니다.

Amazon Web Services의 CMK를 대표적인 예로 들면 가능한 메시지는 다음과 같습니다:

  • CMK가 등록되었지만 아직 Tri-Secret Secure를 사용하도록 활성화되지 않음:
CMK with ARN: arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59
is pre-registered for Tri-Secret Secure.
  • CMK가 활성화되어 Tri-Secret Secure와 함께 사용 중:
CMK with ARN: arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59
is activated for Tri-Secret Secure.
  • 활성 CMK가 있고 방금 새 키를 사전 등록함:
CMK with ARN: arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59
is activated with Tri-Secret Secure, but
CMK with ARN: arn:aws:kms:us-west-2:481048248138:key/e08cb6c0-7c09-4f37-8e55-e395a12fe965
is pre-registered for Tri-Secret Secure.
  • 활성 키가 있지만 Tri-Secret Secure를 사용할 CMK를 등록하지 않음:
CMK info has not been pre-registered in this account yet, but
CMK arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59
is activated with Tri-Secret Secure.
  • Tri-Secret Secure를 사용할 CMK를 전혀 등록하지 않음:
CMK info has not been pre-registered in this account yet.
  • 활성 CMK가 프라이빗 연결 활성화 상태로 등록됨:
CMK with ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
with PrivateLink enabled is activated for Tri-Secret Secure.
  • 활성 CMK가 프라이빗 연결 비활성화 상태로 등록됨:
CMK with ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
is activated for Tri-Secret Secure.

접근 제어 요구 사항

  • ACCOUNTADMIN 역할을 가진 사용자 또는 MONITOR SECURITY 권한이 부여된 역할을 가진 사용자만 이 함수를 호출할 수 있습니다.
  • GLOBALORGADMIN 역할 또는 ORGADMIN 역할을 가진 사용자만 SSA 계정 이름을 지정할 수 있습니다.

예제 (Examples)

Snowflake 계정의 CMK 상태를 가져옵니다:

SELECT SYSTEM$GET_CMK_INFO();

특정 SSA 계정의 CMK 상태를 가져옵니다:

SELECT SYSTEM$GET_CMK_INFO('AUTO_FULFILLMENT_AREA$PUBLIC_AZURE_EASTUS2');

더 알아보기 (Learn more)