授予及撤銷 API 的存取權

前往 Endpoints 服務頁面

• 服務消費者：這個角色包含非專案成員的權限，可讓他們在自己的專案中查看及啟用 API。如果您已為 API 建立入口網站，這個角色即可讓您的 API 使用者存取該入口網站。
• 服務控制器：這個角色包含在執行階段呼叫 Service Infrastructure API 中 check 和 report 方法的權限。
• Service Config Editor (服務設定編輯者)：這個角色包含 Service Management 將 Endpoints 設定部署到現有服務所需的最低權限。
• 服務管理員：這個角色包含「服務設定編輯者」、「服務消費者」和「服務控制器」角色中的權限，以及使用 gcloud 或「 授予、變更及撤銷資源存取權」一文所述的程式輔助方法，授予此 API 存取權所需的權限。

如需這個角色的相關資訊，請參閱 Service Management API 存取權控管主題。雖然 Google Cloud 主控台可讓您選取其他角色，但這些角色對於管理 API 都派不上用場。

• 如要為使用者授予存取權，請執行以下指令：
  

  gcloud endpoints services add-iam-policy-binding [SERVICE-NAME] \
    --member='user:[EMAIL-ADDRESS]' \
    --role='[ROLE]'

  為該角色指定下列其中一個 IAM 角色：

  • roles/servicemanagement.configEditor：這個角色包含 Service Management 將 Endpoints 設定部署到現有服務所需的最低權限。
  • roles/servicemanagement.admin：這個角色包含 roles/servicemanagement.configEditor、roles/servicemanagement.serviceConsumer 和 roles/servicemanagement.serviceController 中的權限，以及使用 gcloud 或「授予、變更及撤銷資源存取權」一文中所述的程式輔助方法，授予此 API 存取權所需的權限。

  例如：

  gcloud endpoints services add-iam-policy-binding example-service-name \
    --member='user:example-user@gmail.com' \
    --role='roles/servicemanagement.admin'

• 如要為服務帳戶授予存取權，請執行以下指令：
  

  gcloud endpoints services add-iam-policy-binding [SERVICE-NAME] \
    --member='serviceAccount:[EMAIL-ADDRESS]' \
    --role='[ROLE]'

  例如：

  gcloud endpoints services add-iam-policy-binding example-service-name \
    --member='serviceAccount:example-service-account@example-project.iam.gserviceaccount.com' \
    --role='roles/servicemanagement.configEditor'

• 如要將存取權授予 Google 群組，請執行以下指令：
  

  gcloud endpoints services add-iam-policy-binding [SERVICE-NAME] \
    --member='group:[GROUP-NAME]@googlegroups.com' \
    --role='[ROLE]'

  例如：

  gcloud endpoints services add-iam-policy-binding example-service-name \
    --member='group:example-group@googlegroups.com' \
    --role='roles/servicemanagement.configEditor'

前往 Endpoints 服務頁面

• 如要為使用者撤銷存取權，請執行以下指令：

  gcloud endpoints services remove-iam-policy-binding [SERVICE-NAME] \
    --member='user:[EMAIL-ADDRESS]' \
    --role='[ROLE-NAME]'

  例如：

  gcloud endpoints services remove-iam-policy-binding example-service-name \
    --member='user:example-user@gmail.com' \
    --role='roles/editor'

• 如要為服務帳戶撤銷存取權，請執行以下指令：

  gcloud endpoints services remove-iam-policy-binding [SERVICE-NAME] \
    --member='serviceAccount:[EMAIL-ADDRESS]' \
    --role='[ROLE-NAME]'

  例如：

  gcloud endpoints services remove-iam-policy-binding example-service-name \
    --member='serviceAccount:example-service-account@example-project.iam.gserviceaccount.com' \
    --role='roles/servicemanagement.configEditor'

• 如要為 Google 群組撤銷存取權，請執行以下指令：

  gcloud endpoints services remove-iam-policy-binding [SERVICE-NAME] \
        --member='group:[GROUP-NAME]@googlegroups.com' \
        --role='[ROLE-NAME]'

  例如：

  gcloud endpoints services remove-iam-policy-binding example-service-name \
        --member='group:example-group@googlegroups.com' \
        --role='roles/viewer'