Cloud Logging API (logging:v2)

2023-02-17

10 new methods

Additions

    Methods
  • logging.locations.buckets.createAsync

      Parameter Order: parent

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Path: v2/{+parent}/buckets:createAsync

      HTTP Method: POST

      Flat Path: v2/{v2Id}/{v2Id1}/locations/{locationsId}/buckets:createAsync

      Description: Creates a log bucket asynchronously that can be used to store log entries.After a bucket has been created, the bucket's location cannot be changed.

      Parameters:

        parent

          Description: Required. The resource in which to create the log bucket: "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global"

          Location: path

          Required: Yes

          Pattern: ^[^/]+/[^/]+/locations/[^/]+$

          Type: string

        bucketId

          Type: string

          Description: Required. A client-assigned identifier such as "my-bucket". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.

          Location: query

  • logging.locations.buckets.updateAsync

      Flat Path: v2/{v2Id}/{v2Id1}/locations/{locationsId}/buckets/{bucketsId}:updateAsync

      Parameter Order: name

      HTTP Method: POST

      Description: Updates a log bucket asynchronously.If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has been created, the bucket's location cannot be changed.

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Parameters:

        updateMask

          Format: google-fieldmask

          Type: string

          Location: query

          Description: Required. Field mask that specifies the fields in bucket that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=retention_days

        name

          Type: string

          Description: Required. The full resource name of the bucket to update. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket"

          Location: path

          Pattern: ^[^/]+/[^/]+/locations/[^/]+/buckets/[^/]+$

          Required: Yes

      Path: v2/{+name}:updateAsync

  • logging.projects.locations.buckets.createAsync

      Parameters:

        parent

          Required: Yes

          Type: string

          Location: path

          Description: Required. The resource in which to create the log bucket: "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global"

          Pattern: ^projects/[^/]+/locations/[^/]+$

        bucketId

          Location: query

          Type: string

          Description: Required. A client-assigned identifier such as "my-bucket". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.

      HTTP Method: POST

      Path: v2/{+parent}/buckets:createAsync

      Parameter Order: parent

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Description: Creates a log bucket asynchronously that can be used to store log entries.After a bucket has been created, the bucket's location cannot be changed.

      Flat Path: v2/projects/{projectsId}/locations/{locationsId}/buckets:createAsync

  • logging.projects.locations.buckets.updateAsync

      Flat Path: v2/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}:updateAsync

      Description: Updates a log bucket asynchronously.If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has been created, the bucket's location cannot be changed.

      Parameters:

        updateMask

          Location: query

          Description: Required. Field mask that specifies the fields in bucket that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=retention_days

          Type: string

          Format: google-fieldmask

        name

          Pattern: ^projects/[^/]+/locations/[^/]+/buckets/[^/]+$

          Required: Yes

          Type: string

          Description: Required. The full resource name of the bucket to update. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket"

          Location: path

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Parameter Order: name

      Path: v2/{+name}:updateAsync

      HTTP Method: POST

  • logging.billingAccounts.locations.buckets.updateAsync

      Parameter Order: name

      HTTP Method: POST

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Flat Path: v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/buckets/{bucketsId}:updateAsync

      Path: v2/{+name}:updateAsync

      Parameters:

        name

          Description: Required. The full resource name of the bucket to update. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket"

          Location: path

          Type: string

          Required: Yes

          Pattern: ^billingAccounts/[^/]+/locations/[^/]+/buckets/[^/]+$

        updateMask

          Type: string

          Format: google-fieldmask

          Description: Required. Field mask that specifies the fields in bucket that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=retention_days

          Location: query

      Description: Updates a log bucket asynchronously.If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has been created, the bucket's location cannot be changed.

  • logging.billingAccounts.locations.buckets.createAsync

      HTTP Method: POST

      Flat Path: v2/billingAccounts/{billingAccountsId}/locations/{locationsId}/buckets:createAsync

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Description: Creates a log bucket asynchronously that can be used to store log entries.After a bucket has been created, the bucket's location cannot be changed.

      Parameters:

        parent

          Description: Required. The resource in which to create the log bucket: "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global"

          Required: Yes

          Location: path

          Type: string

          Pattern: ^billingAccounts/[^/]+/locations/[^/]+$

        bucketId

          Location: query

          Type: string

          Description: Required. A client-assigned identifier such as "my-bucket". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.

      Parameter Order: parent

      Path: v2/{+parent}/buckets:createAsync

  • logging.organizations.locations.buckets.createAsync

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Description: Creates a log bucket asynchronously that can be used to store log entries.After a bucket has been created, the bucket's location cannot be changed.

      HTTP Method: POST

      Parameters:

        parent

          Type: string

          Location: path

          Pattern: ^organizations/[^/]+/locations/[^/]+$

          Description: Required. The resource in which to create the log bucket: "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global"

          Required: Yes

        bucketId

          Description: Required. A client-assigned identifier such as "my-bucket". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.

          Type: string

          Location: query

      Path: v2/{+parent}/buckets:createAsync

      Parameter Order: parent

      Flat Path: v2/organizations/{organizationsId}/locations/{locationsId}/buckets:createAsync

  • logging.organizations.locations.buckets.updateAsync

      HTTP Method: POST

      Path: v2/{+name}:updateAsync

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Description: Updates a log bucket asynchronously.If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has been created, the bucket's location cannot be changed.

      Parameter Order: name

      Flat Path: v2/organizations/{organizationsId}/locations/{locationsId}/buckets/{bucketsId}:updateAsync

      Parameters:

        name

          Required: Yes

          Description: Required. The full resource name of the bucket to update. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket"

          Location: path

          Type: string

          Pattern: ^organizations/[^/]+/locations/[^/]+/buckets/[^/]+$

        updateMask

          Format: google-fieldmask

          Location: query

          Type: string

          Description: Required. Field mask that specifies the fields in bucket that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=retention_days

  • logging.folders.locations.buckets.createAsync

      Description: Creates a log bucket asynchronously that can be used to store log entries.After a bucket has been created, the bucket's location cannot be changed.

      Path: v2/{+parent}/buckets:createAsync

      Flat Path: v2/folders/{foldersId}/locations/{locationsId}/buckets:createAsync

      HTTP Method: POST

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Parameter Order: parent

      Parameters:

        parent

          Pattern: ^folders/[^/]+/locations/[^/]+$

          Type: string

          Location: path

          Required: Yes

          Description: Required. The resource in which to create the log bucket: "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global"

        bucketId

          Location: query

          Type: string

          Description: Required. A client-assigned identifier such as "my-bucket". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.

  • logging.folders.locations.buckets.updateAsync

      Path: v2/{+name}:updateAsync

      Flat Path: v2/folders/{foldersId}/locations/{locationsId}/buckets/{bucketsId}:updateAsync

      Description: Updates a log bucket asynchronously.If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has been created, the bucket's location cannot be changed.

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/logging.admin
    • Parameter Order: name

      HTTP Method: POST

      Parameters:

        name

          Location: path

          Description: Required. The full resource name of the bucket to update. "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/global/buckets/my-bucket"

          Required: Yes

          Type: string

          Pattern: ^folders/[^/]+/locations/[^/]+/buckets/[^/]+$

        updateMask

          Format: google-fieldmask

          Description: Required. Field mask that specifies the fields in bucket that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=retention_days

          Location: query

          Type: string