이 페이지에서는 인증서 관리자에서 장기 실행 작업을 확인하고 관리하는 방법을 설명합니다.
리소스 만들기, 업데이트, 삭제와 같은 인증서 관리자의 mutate 요청이 즉시 실패하지 않으면 API는 장기 실행 작업 (LRO)을 반환합니다. 이러한 작업은 완료하는 데 시간이 더 오래 걸리는 처리 태스크의 상태를 추적합니다. 기본적으로 gcloud 변형 명령어는 --async 플래그를 지정하지 않는 한 작업이 완료될 때까지 대기합니다.
projects.locations.operations 컬렉션을 사용하여 작업 상태를 확인할 수 있습니다.
필수 권한
대상 프로젝트에서 장기 실행 작업을 관리하려면 수행하려는 태스크에 해당하는 권한이 있어야 합니다.
certificatemanager.operations.get: 특정 작업의 세부정보를 가져옵니다.certificatemanager.operations.list: 지정된 위치의 모든 작업을 나열합니다.certificatemanager.operations.delete: 완료된 작업 리소스를 삭제합니다 (API만 해당).
역할 및 권한에 대한 자세한 내용은 역할 및 권한을 참조하세요.
장기 실행 작업에 대한 세부정보 가져오기
인증서 만들기와 같이 작업을 시작하는 호출을 수행하면 응답에 projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID 형식의 작업 이름이 포함됩니다.
작업이 완료되었는지 확인하려면 대상 작업에 대한 세부정보를 요청합니다. 응답에 "done": false가 포함되어 있거나 "done" 필드가 포함되어 있지 않으면 작업이 아직 진행 중인 것입니다. 응답에 "done": true가 표시될 때까지 상태를 다시 확인합니다.
gcloud
장기 실행 작업을 설명하려면 certificate-manager
operations describe 명령어를 사용합니다.
gcloud certificate-manager operations describe OPERATION_ID \
--location="LOCATION"
다음을 바꿉니다.
OPERATION_ID: 작업 ID입니다.LOCATION: 대상 Google Cloud 위치입니다. 기본 위치는global입니다.
API
장기 실행 작업에 대한 세부정보를 가져오려면 projects.locations.operations.get 메서드에 GET 요청을 보냅니다.
GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트의 ID입니다.LOCATION: 대상 Google Cloud 위치입니다. 기본 위치는global입니다.OPERATION_ID: 작업 ID입니다.
장기 실행 작업 나열
작업을 나열하여 작업 ID를 찾고 프로젝트에서 활성 수정사항을 모니터링할 수 있습니다.
gcloud
지정된 위치의 작업을 나열하려면 certificate-manager
operations list 명령어를 사용합니다.
gcloud certificate-manager operations list \
--location="LOCATION"
다음을 바꿉니다.
LOCATION: 대상 Google Cloud 위치입니다. 기본 위치는global입니다.
API
위치의 작업을 나열하려면 projects.locations.operations.list 메서드에 GET 요청을 수행합니다.
GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations
다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트의 ID입니다.LOCATION: 타겟 Google Cloud 위치입니다. 기본 위치는global입니다.
완료된 장기 실행 작업 삭제
결과가 더 이상 필요하지 않으면 완료된 작업 리소스를 삭제할 수 있습니다. 완료된 작업을 삭제하면 작업 레코드만 삭제되고 작업으로 인한 변경사항은 취소되거나 되돌려지지 않습니다.
gcloud 명령어를 사용하여 작업을 삭제할 수 없습니다. 대신 REST API를 사용하세요.
API
완료된 작업을 삭제하려면 DELETE 요청을 projects.locations.operations.delete 메서드에 전송합니다.
DELETE https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트의 ID입니다.LOCATION: 대상 Google Cloud 위치입니다. 기본 위치는global입니다.OPERATION_ID: 작업 ID입니다.
보관 정책
인증서 관리자는 다음 규칙에 따라 완료된 LRO를 우선순위에 따라 자동으로 보관하고 삭제합니다.
- 1시간 이내: 1시간 이내에 완료된 작업은 인증서 관리자가 작업을 보관합니다.
- 1주일 이상 경과: 작업이 1주일 전에 완료된 경우 인증서 관리자가 작업을 삭제합니다.
- 최대 한도: 작업이 1시간에서 1주일 전에 완료된 경우 인증서 관리자는 각 프로젝트에서 가장 최근에 완료된 작업을 최대 5,000개까지 보관하고 오래된 완료된 작업을 삭제합니다.
다음 예시에서는 이러한 규칙이 적용되는 방식을 보여줍니다.
- 프로젝트에 완료된 작업이 10,000개 있고 모두 1시간 미만인 경우 인증서 관리자는 10,000개 작업을 모두 보관합니다.
- 프로젝트에 완료된 작업이 1,000개 있고 모두 1주일이 넘은 경우 인증서 관리자는 1,000개 작업을 모두 삭제합니다.
- 프로젝트에 완료된 작업이 10,000개 있고 모두 1시간에서 1주일 사이인 경우 인증서 관리자는 최근 작업 5,000개만 보관합니다.