Method: projects.guestPolicies.create

Create an OS Config guest policy.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The resource name of the parent using one of the following forms: projects/{project_number}.

Query parameters



Required. The logical name of the guest policy in the project with the following restrictions:

  • Must contain only lowercase letters, numbers, and hyphens.
  • Must start with a letter.
  • Must be between 1-63 characters.
  • Must end with a number or a letter.
  • Must be unique within the project.

Request body

The request body contains an instance of GuestPolicy.

Response body

If successful, the response body contains a newly created instance of GuestPolicy.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • osconfig.guestPolicies.create

For more information, see the IAM documentation.