이 문서에서는 배치 정책을 보는 방법을 설명합니다.
배치 정책을 보면 프로젝트의 모든 기존 배치 정책을 보거나 특정 배치 정책의 구성 세부정보를 확인하는 데 유용합니다.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
배치 정책 목록 보기:
compute.resourcePolicies.list
on the project -
배치 정책 세부정보 보기:
compute.resourcePolicies.get
on the project 프로젝트의 모든 기존 배치 정책을 보려면 배치 정책 목록을 봅니다.
배치 정책의 구성 세부정보를 확인하려면 배치 정책 세부정보를 봅니다.
PROJECT_ID
: 배치 정책 목록을 보려는 프로젝트의 ID입니다.REGION
: 배치 정책이 하나 이상 있는 리전입니다.POLICY_NAME
: 기존 배치 정책의 이름입니다.REGION
: 배치 정책이 있는 리전입니다.압축 배치 정책의 세부정보를 보는 경우 다음 안내를 따르세요.
creationTimestamp: '2024-05-09T02:09:24.588-07:00' groupPlacementPolicy: collocation: COLLOCATED id: '5587673659722509355' kind: compute#resourcePolicy name: example-compact-policy region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy status: READY
분산 배치 정책의 세부정보를 보는 경우 다음 안내를 따르세요.
creationTimestamp: '2024-05-09T02:08:13.404-07:00' groupPlacementPolicy: availabilityDomainCount: 5 id: '5970772604948130963' kind: compute#resourcePolicy name: example-spread-policy region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy status: READY
PROJECT_ID
: 세부정보를 보려는 배치 정책이 있는 프로젝트의 ID입니다.REGION
: 배치 정책이 있는 리전입니다.POLICY_NAME
: 기존 배치 정책의 이름입니다.압축 배치 정책의 세부정보를 보는 경우 다음 안내를 따르세요.
{ "kind": "compute#resourcePolicy", "id": "5587673659722509355", "creationTimestamp": "2024-05-09T02:09:24.588-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-compact-policy", "groupPlacementPolicy": { "collocation": "COLLOCATED" }, "status": "READY" }
분산 배치 정책의 세부정보를 보는 경우 다음 안내를 따르세요.
{ "kind": "compute#resourcePolicy", "id": "5970772604948130963", "creationTimestamp": "2024-05-09T02:08:13.404-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-spread-policy", "groupPlacementPolicy": { "availabilityDomainCount": 5 }, "status": "READY" }
배치 정책을 교체 또는 삭제하는 방법을 알아봅니다.
배치 정책을 적용하는 방법을 알아봅니다.
압축 배치 정책을 사용하는 VM 위치를 확인하는 방법을 알아봅니다.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참고하세요.
필요한 역할
배치 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자(v1)(
roles/compute.instanceAdmin.v1
) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.이 사전 정의된 역할에는 배치 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
배치 정책을 보려면 다음 권한이 필요합니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
배치 정책 보기
프로젝트에서 사용할 수 있는 배치 정책을 보려면 이 문서에 설명된 다음 방법 중 하나를 선택합니다.
배치 정책 목록 보기
프로젝트의 모든 배치 정책 목록을 보려면 다음 옵션 중 하나를 선택합니다.
gcloud
배치 정책 목록을 보려면
--filter
플래그를groupPlacementPolicy:*
로 설정하고gcloud compute resource-policies list
명령어를 사용합니다.gcloud compute resource-policies list \ --filter="groupPlacementPolicy:*"
출력은 다음과 비슷합니다.
NAME: example-compact-policy DESCRIPTION: REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00 NAME: example-spread-policy DESCRIPTION: REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-07:00
필터 표현식을 사용하여 Compute Engine 리소스 목록 범위를 좁히는 방법에 대한 자세한 내용은
gcloud topic filters
명령어를 참조하세요.REST
특정 리전에 있는 배치 정책 목록을 보려면
resourcePolicies.list
메서드에 대해GET
요청을 수행합니다. 요청 URL에filter
쿼리 매개변수를 포함하고groupPlacementPolicy%3A*
로 설정합니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=groupPlacementPolicy%3A*
다음을 바꿉니다.
출력은 다음과 비슷합니다.
{ "kind": "compute#resourcePolicyList", "id": "projects/example-project/regions/us-central1/resourcePolicies", "items": [ { "kind": "compute#resourcePolicy", "id": "5587673659722509355", "creationTimestamp": "2024-05-09T02:09:24.588-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-compact-policy", "groupPlacementPolicy": { "collocation": "COLLOCATED" }, "status": "READY" }, { "kind": "compute#resourcePolicy", "id": "5970772604948130963", "creationTimestamp": "2024-05-09T02:08:13.404-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-spread-policy", "groupPlacementPolicy": { "availabilityDomainCount": 5 }, "status": "READY" } ], "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies", "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis=" }
필터 표현식을 사용하여 URL 인코딩을 사용하는 리소스 정책 목록 범위를 좁히는 방법에 대한 자세한 내용은
filter
쿼리 매개변수를 참조하세요.배치 정책 세부정보 보기
배치 정책 세부정보를 보려면 다음 옵션 중 하나를 선택합니다.
gcloud
배치 정책 세부정보를 보려면
gcloud compute resource-policies describe
명령어를 사용합니다.gcloud compute resource-policies describe POLICY_NAME \ --region=REGION
다음을 바꿉니다.
출력은 다음과 비슷합니다.
REST
배치 정책 세부정보를 보려면
resourcePolicies.get
메서드에GET
요청을 보냅니다.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
다음을 바꿉니다.
출력은 다음과 비슷합니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-22(UTC)
-