카테고리:

시스템 함수 (시스템 정보)

SYSTEM$GET_CMK_INFO

|tri-secret-secure|와 함께 사용할 고객 관리 키(CMK)의 상태를 반환합니다.

참고 항목:

|tri-secret-secure|의 활성화를 지원하는 CMK 자체 등록 이해

구문

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

인자

필수:

없습니다.

선택 사항:

ssa_account_name

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

반환

CMK의 상태를 나타내는 상태 메시지를 반환합니다. 출력에는 :doc:`system_register_cmk_info`를 호출할 때 지정한 값이 포함됩니다. 비공개 연결을 활성화한 경우 SYSTEM$GET_CMK_INFO에서 반환된 상태 메시지에 CMK가 비공개로 연결되어 있는지 여부가 포함됩니다.

대표적인 예제로 Amazon Web Services 에서 CMKs를 사용하면 다음과 같은 메시지가 가능합니다.

  • 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 계정 이름을 지정할 수 있습니다.

예

Snowflake 계정에 대한 CMK 상태를 가져옵니다.

SELECT SYSTEM$GET_CMK_INFO();

특정 SSA 계정에 대한 CMK의 상태를 가져옵니다.

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