서비스 사용 설정 및 중지

서비스 사용량을 사용하여 Google Cloud 프로젝트에 사용 가능한 모든 서비스를 사용 설정 또는 중지할 수 있습니다. 여기에는 공개 Google Cloud 서비스와 Cloud Endpoints로 생성된 비공개 서비스가 포함됩니다. 공개 서비스와 비공개 서비스의 차이점에 대해 자세히 알아보려면 공개 및 비공개 서비스를 참고하세요.

대부분의 사용자는 Google Cloud 콘솔을 사용하여 서비스를 사용 설정 및 중지할 수 있습니다. 스크립트의 경우 Google Cloud CLI를 사용하세요. 프로그래매틱 방식으로 Service Usage API에 액세스하려면 클라이언트 라이브러리를 사용하는 것이 좋습니다. API를 사용해 보려면 전체 개발 환경을 설정하지 않고 요청을 전송하면 됩니다.

서비스 사용량 할당량 한도는 할당량 및 한도를 참고하세요. 청구 가능 사용량을 제한할 수 있습니다. API에 따라 요청을 제한할 수 있습니다.

시작하기 전에

서비스를 사용 설정 및 중지하기 전에 서비스 사용량에 맞게Google Cloud 프로젝트와 환경을 설정해야 합니다.

콘솔

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

gcloud

Google Cloud CLI를 설치합니다.

외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.

gcloud init

Google Cloud 프로젝트를 만들거나 선택합니다.

프로젝트를 선택하거나 만드는 데 필요한 역할

프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기

Google Cloud 프로젝트를 만듭니다.
```
gcloud projects create PROJECT_ID
```
PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다.
생성한 Google Cloud 프로젝트를 선택합니다.
```
gcloud config set project PROJECT_ID
```
PROJECT_ID을 Google Cloud 프로젝트 이름으로 바꿉니다.

이 가이드에 기존 프로젝트를 사용하는 경우 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다. 새 프로젝트를 만든 경우에는 이미 필요한 권한이 있습니다.

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Service Usage API를 사용 설정합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할 (roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

gcloud services enable serviceusage.googleapis.com

Google Cloud CLI를 설치합니다.

외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다.

gcloud init

Google Cloud 프로젝트를 만들거나 선택합니다.

프로젝트를 선택하거나 만드는 데 필요한 역할

프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기

Google Cloud 프로젝트를 만듭니다.
```
gcloud projects create PROJECT_ID
```
PROJECT_ID를 만들려는 Google Cloud 프로젝트의 이름으로 바꿉니다.
생성한 Google Cloud 프로젝트를 선택합니다.
```
gcloud config set project PROJECT_ID
```
PROJECT_ID을 Google Cloud 프로젝트 이름으로 바꿉니다.

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

Service Usage API를 사용 설정합니다.

API 사용 설정에 필요한 역할

gcloud services enable serviceusage.googleapis.com

필요한 역할

서비스를 사용 설정 및 사용 중지하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 서비스 사용량 관리자 (roles/serviceusage.serviceUsageAdmin) IAM 역할을 부여해 달라고 요청합니다. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

서비스 사용 설정

서비스를 사용 설정하는 과정은 다를 수 있습니다. 일부 API는 사용하려면 먼저 서비스 약관에 동의해야 하거나 미리보기 상태이므로 승인이 필요합니다. 그 밖에 조직의 연락처 세부정보와 애플리케이션 이름 등 추가 정보를 요구하는 API도 있습니다. 요청된 정보는 Google 내에서 기밀로 유지됩니다. 이 정보는 API 사용량을 파악하고 필요한 경우 연락하는 데 사용됩니다.

콘솔

Google Cloud 콘솔에서 API 및 서비스 > API 라이브러리 페이지로 이동합니다.

API 라이브러리로 이동
최근 프로젝트를 선택하거나 콘솔 툴바의 리소스 선택기를 사용하여 API를 사용 설정할 Google Cloud 프로젝트를 선택합니다.
사용 설정할 API를 클릭하거나 API 및 서비스 검색 상자를 사용하여 검색합니다.
사용 설정을 클릭합니다.

gcloud

gcloud services enable 명령어는 현재 프로젝트에 지정된 이름의 서비스를 사용 설정합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

SERVICE: 사용 설정할 서비스의 이름입니다.

gcloud services enable 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud services enable SERVICE

Windows(PowerShell)

gcloud services enable SERVICE

Windows(cmd.exe)

gcloud services enable SERVICE

다음과 비슷한 응답이 표시됩니다.


Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

여러 서비스를 사용 설정하려면 공백으로 구분된 서비스 이름을 사용합니다. 예를 들어 다음 명령어는 BigQuery와 Pub/Sub 서비스를 모두 사용 설정합니다.

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

작업 세부정보를 가져오려면 gcloud services operations describe 명령어를 사용합니다.

gcloud services operations describe operations/OPERATION_ID

OPERATION_ID을 원래 요청에 대한 응답으로 수신한 작업 ID로 바꿉니다.

REST API

단일 서비스 사용 설정

단일 서비스를 사용 설정하려면 services.enable 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud프로젝트 ID
SERVICE: 사용 설정할 서비스의 이름입니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

성공한 경우 응답 본문에 새로 생성된 Operation 인스턴스가 포함됩니다.

{
  "name": "operations/OPERATION_ID"
}

여러 서비스 사용 설정

단일 작업에서 최대 20개의 서비스를 사용 설정하려면 services.batchEnable 메서드를 사용하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud프로젝트 ID
SERVICE1: 사용 설정할 서비스의 이름입니다.
SERVICE2: 사용 설정할 다른 서비스의 이름입니다.

JSON 요청 본문:

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

성공한 경우 응답 본문에 새로 생성된 Operation 인스턴스가 포함됩니다.

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

서비스 사용 중지

언제든지 프로젝트의 API를 사용 중지할 수 있습니다. 단, 미결제 비용과 프로젝트의 청구 가능한 API 사용에 대해서는 요금이 부과됩니다. 자세한 내용은 Cloud API의 시작하기 가이드를 참고하세요.

Cloud Storage 및 BigQuery와 같은 많은 서비스에서 데이터 저장 요금이 청구됩니다. 서비스의 API를 사용 중지해도 데이터는 삭제되지 않으며 계속 요금이 청구됩니다. 향후 요금이 청구되지 않도록 하고 서비스 사용을 중단하려면 API를 사용 중지하기 전에 연결된 모든 데이터를 삭제하세요.

Google Kubernetes Engine API를 사용 중지하면 프로젝트에서 실행 중인 클러스터가 정지됩니다. 30일 후에는 정지된 클러스터가 삭제됩니다. 클러스터를 다시 활성화하려면 GKE API를 다시 사용 설정하세요. 클러스터가 복구되기까지 최대 24시간이 걸릴 수 있습니다. 자세한 내용은 클러스터 수명 주기를 참고하세요.

콘솔

Google Cloud 콘솔에서 API 및 서비스 > API 라이브러리 페이지로 이동합니다.

API 라이브러리로 이동
최근 프로젝트를 선택하거나 콘솔 툴바의 리소스 선택기를 사용하여 API를 사용 중지할 Google Cloud 프로젝트를 선택합니다.
사용 중지할 API를 클릭하거나 API 및 서비스 검색 상자를 사용하여 검색합니다.
API 사용 중지를 클릭합니다.

gcloud

gcloud services disable 명령어는 현재 프로젝트에 지정된 이름의 서비스를 사용 중지합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

SERVICE: 사용 중지할 서비스의 이름입니다.

gcloud services disable 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud services disable SERVICE

Windows(PowerShell)

gcloud services disable SERVICE

Windows(cmd.exe)

gcloud services disable SERVICE

다음과 비슷한 응답이 표시됩니다.


Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

여러 서비스를 사용 중지하려면 공백으로 구분된 서비스 이름을 사용합니다. 예를 들어 다음 명령어는 BigQuery와 Pub/Sub 서비스를 모두 사용 중지합니다.

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

작업 세부정보를 가져오려면 gcloud services operations describe 명령어를 사용합니다.

gcloud services operations describe operations/OPERATION_ID

OPERATION_ID을 원래 요청에 대한 응답으로 수신한 작업 ID로 바꿉니다.

REST API

서비스를 사용 중지하려면 services.disable 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud프로젝트 ID
SERVICE: 사용 중지할 서비스의 이름입니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

성공한 경우 응답 본문에 새로 생성된 Operation 인스턴스가 포함됩니다.

{
  "name": "operations/OPERATION_ID"
}

장기 실행 작업의 상태 확인

사용 설정 또는 사용 중지 메서드를 사용하면 장기 실행 작업 (LRO)이 반환됩니다. LRO는 요청의 상태를 추적하고 서비스 변경이 완료되었는지 여부를 나타냅니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

OPERATION_ID: 작업 식별자입니다. 원래 요청에 대한 응답으로 이 ID가 수신됩니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

done 필드가 true로 설정되면 작업이 완료됩니다.