{ "version": "v1", "version_module": true, "baseUrl": "https://certificatemanager.googleapis.com/", "schemas": { "ListLocationsResponse": { "properties": { "locations": { "type": "array", "items": { "$ref": "Location" }, "description": "A list of locations that matches the specified filter in the request." }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." } }, "id": "ListLocationsResponse", "type": "object", "description": "The response message for Locations.ListLocations." }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", "type": "object", "properties": {} }, "Troubleshooting": { "id": "Troubleshooting", "type": "object", "description": "Troubleshooting information for the authorization attempt.", "properties": { "ips": { "description": "Output only. IPs troubleshooting information.", "$ref": "IPs", "readOnly": true }, "issues": { "readOnly": true, "description": "Output only. The list of issues discovered during the authorization attempt.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "Issue is unspecified.", "The resolved CNAME value doesn't match the expected CNAME.", "Domain has A/AAAA records that point to IPs, where the certificate is not attached.", "Domain has A/AAAA records that point to IPs, where the certificate is attached, but port 443 is not open.", "Domain doesn't have any A/AAAA records.", "Certificate is not configured to be served from any IPs (e.g. Certificate is not attached to any load balancer)." ], "enum": [ "ISSUE_UNSPECIFIED", "CNAME_MISMATCH", "RESOLVED_TO_NOT_SERVING", "RESOLVED_TO_SERVING_ON_ALT_PORTS", "NO_RESOLVED_IPS", "CERTIFICATE_NOT_ATTACHED" ] } }, "cname": { "readOnly": true, "description": "Output only. CNAME troubleshooting information.", "$ref": "CNAME" } } }, "ListCertificateMapEntriesResponse": { "description": "Response for the `ListCertificateMapEntries` method.", "id": "ListCertificateMapEntriesResponse", "type": "object", "properties": { "certificateMapEntries": { "description": "A list of certificate map entries for the parent resource.", "type": "array", "items": { "$ref": "CertificateMapEntry" } }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } }, "nextPageToken": { "type": "string", "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`." } } }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "id": "Operation", "type": "object", "properties": { "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "response": { "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "metadata": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object", "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any." }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." } } }, "ManagedIdentityCertificate": { "properties": { "identity": { "description": "Required. Immutable. SPIFFE ID of the Managed Identity used for this certificate.", "type": "string" }, "state": { "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "FAILED", "ACTIVE" ], "description": "Output only. State of the managed certificate resource.", "enumDescriptions": [ "State is unspecified.", "Certificate Manager attempts to provision or renew the certificate. If the process takes longer than expected, consult the `provisioning_issue` field.", "Multiple certificate provisioning attempts failed and Certificate Manager gave up. To try again, delete and create a new managed Certificate resource. For details see the `provisioning_issue` field.", "The certificate management is working, and a certificate has been provisioned." ], "type": "string", "readOnly": true }, "provisioningIssue": { "readOnly": true, "description": "Output only. Information about issues with provisioning a managed certificate.", "$ref": "ProvisioningIssue" } }, "id": "ManagedIdentityCertificate", "type": "object", "description": "Configuration and state of a Managed Identity Certificate. Certificate Manager provisions and renews Managed Identity Certificates automatically, for as long as it's authorized to do so." }, "CertificateIssuanceConfig": { "description": "CertificateIssuanceConfig specifies how to issue and manage a certificate.", "id": "CertificateIssuanceConfig", "type": "object", "properties": { "description": { "type": "string", "description": "Optional. One or more paragraphs of text description of a CertificateIssuanceConfig." }, "rotationWindowPercentage": { "format": "int32", "description": "Required. Specifies the percentage of elapsed time of the certificate lifetime to wait before renewing the certificate. Must be a number between 1-99, inclusive.", "type": "integer" }, "name": { "description": "Identifier. A user-defined name of the certificate issuance config. CertificateIssuanceConfig names must be unique globally and match pattern `projects/*/locations/*/certificateIssuanceConfigs/*`.", "type": "string" }, "createTime": { "type": "string", "description": "Output only. The creation timestamp of a CertificateIssuanceConfig.", "readOnly": true, "format": "google-datetime" }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The last update timestamp of a CertificateIssuanceConfig.", "type": "string" }, "certificateAuthorityConfig": { "description": "Required. The CA that issues the workload certificate. It includes the CA address, type, authentication to CA service, etc.", "$ref": "CertificateAuthorityConfig" }, "lifetime": { "format": "google-duration", "type": "string", "description": "Required. Workload certificate lifetime requested." }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. Set of labels associated with a CertificateIssuanceConfig." }, "keyAlgorithm": { "type": "string", "description": "Required. The key algorithm to use when generating the private key.", "enumDescriptions": [ "Unspecified key algorithm.", "Specifies RSA with a 2048-bit modulus.", "Specifies ECDSA with curve P256." ], "enum": [ "KEY_ALGORITHM_UNSPECIFIED", "RSA_2048", "ECDSA_P256" ] } } }, "ManagedCertificate": { "properties": { "state": { "description": "Output only. State of the managed certificate resource.", "enumDescriptions": [ "State is unspecified.", "Certificate Manager attempts to provision or renew the certificate. If the process takes longer than expected, consult the `provisioning_issue` field.", "Multiple certificate provisioning attempts failed and Certificate Manager gave up. To try again, delete and create a new managed Certificate resource. For details see the `provisioning_issue` field.", "The certificate management is working, and a certificate has been provisioned." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "PROVISIONING", "FAILED", "ACTIVE" ], "readOnly": true }, "dnsAuthorizations": { "description": "Optional. Immutable. Authorizations that will be used for performing domain authorization.", "type": "array", "items": { "type": "string" } }, "domains": { "description": "Optional. Immutable. The domains for which a managed SSL certificate will be generated. Wildcard domains are only supported with DNS challenge resolution.", "type": "array", "items": { "type": "string" } }, "issuanceConfig": { "description": "Optional. Immutable. The resource name for a CertificateIssuanceConfig used to configure private PKI certificates in the format `projects/*/locations/*/certificateIssuanceConfigs/*`. If this field is not set, the certificates will instead be publicly signed as documented at https://cloud.google.com/load-balancing/docs/ssl-certificates/google-managed-certs#caa.", "type": "string" }, "provisioningIssue": { "description": "Output only. Information about issues with provisioning a Managed Certificate.", "$ref": "ProvisioningIssue", "readOnly": true }, "authorizationAttemptInfo": { "type": "array", "items": { "$ref": "AuthorizationAttemptInfo" }, "description": "Output only. Detailed state of the latest authorization attempt for each domain specified for managed certificate resource.", "readOnly": true } }, "id": "ManagedCertificate", "type": "object", "description": "Configuration and state of a Managed Certificate. Certificate Manager provisions and renews Managed Certificates automatically, for as long as it's authorized to do so." }, "CertificateAuthorityServiceConfig": { "properties": { "caPool": { "description": "Required. A CA pool resource used to issue a certificate. The CA pool string has a relative resource path following the form \"projects/{project}/locations/{location}/caPools/{ca_pool}\".", "type": "string" } }, "id": "CertificateAuthorityServiceConfig", "type": "object", "description": "Contains information required to contact CA service." }, "ProvisioningIssue": { "description": "Information about issues with provisioning a Managed Certificate.", "id": "ProvisioningIssue", "type": "object", "properties": { "reason": { "enum": [ "REASON_UNSPECIFIED", "AUTHORIZATION_ISSUE", "RATE_LIMITED" ], "description": "Output only. Reason for provisioning failures.", "enumDescriptions": [ "Reason is unspecified.", "Certificate provisioning failed due to an issue with one or more of the domains on the certificate. For details of which domains failed, consult the `authorization_attempt_info` field.", "Exceeded Certificate Authority quotas or internal rate limits of the system. Provisioning may take longer to complete." ], "type": "string", "readOnly": true }, "details": { "description": "Output only. Human readable explanation about the issue. Provided to help address the configuration issues. Not guaranteed to be stable. For programmatic access use Reason enum.", "type": "string", "readOnly": true } } }, "TrustAnchor": { "description": "Defines a trust anchor.", "id": "TrustAnchor", "type": "object", "properties": { "pemCertificate": { "type": "string", "description": "PEM root certificate of the PKI used for validation. Each certificate provided in PEM format may occupy up to 5kB." } } }, "DnsResourceRecord": { "properties": { "name": { "readOnly": true, "description": "Output only. Fully qualified name of the DNS Resource Record. e.g. `_acme-challenge.example.com`", "type": "string" }, "type": { "readOnly": true, "description": "Output only. Type of the DNS Resource Record. Currently always set to \"CNAME\".", "type": "string" }, "data": { "description": "Output only. Data of the DNS Resource Record.", "type": "string", "readOnly": true } }, "description": "The structure describing the DNS Resource Record that needs to be added to DNS configuration for the authorization to be usable by certificate.", "id": "DnsResourceRecord", "type": "object" }, "AuthorizationAttemptInfo": { "properties": { "failureReason": { "description": "Output only. Reason for failure of the authorization attempt for the domain.", "enumDescriptions": [ "FailureReason is unspecified.", "There was a problem with the user's DNS or load balancer configuration for this domain.", "Certificate issuance forbidden by an explicit CAA record for the domain or a failure to check CAA records for the domain.", "Reached a CA or internal rate-limit for the domain, e.g. for certificates per top-level private domain." ], "type": "string", "enum": [ "FAILURE_REASON_UNSPECIFIED", "CONFIG", "CAA", "RATE_LIMITED" ], "readOnly": true }, "troubleshooting": { "description": "Output only. Troubleshooting information for the authorization attempt. This field is only populated if the authorization attempt failed.", "$ref": "Troubleshooting", "readOnly": true }, "state": { "description": "Output only. State of the domain for managed certificate issuance.", "enumDescriptions": [ "State is unspecified.", "Certificate provisioning for this domain is under way. Google Cloud will attempt to authorize the domain.", "A managed certificate can be provisioned, no issues for this domain.", "Attempt to authorize the domain failed. This prevents the Managed Certificate from being issued. See `failure_reason` and `details` fields for more information." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "AUTHORIZING", "AUTHORIZED", "FAILED" ], "readOnly": true }, "domain": { "description": "Output only. Domain name of the authorization attempt.", "type": "string", "readOnly": true }, "details": { "type": "string", "description": "Output only. Human readable explanation for reaching the state. Provided to help address the configuration issues. Not guaranteed to be stable. For programmatic access use FailureReason enum.", "readOnly": true }, "attemptTime": { "description": "Output only. The timestamp, when the authorization attempt was made.", "type": "string", "readOnly": true, "format": "google-datetime" } }, "id": "AuthorizationAttemptInfo", "type": "object", "description": "State of the latest attempt to authorize a domain for certificate issuance." }, "ListOperationsResponse": { "properties": { "operations": { "description": "A list of operations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Operation" } }, "unreachable": { "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", "type": "array", "items": { "type": "string" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "description": "The response message for Operations.ListOperations.", "id": "ListOperationsResponse", "type": "object" }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", "type": "object", "properties": { "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "code": { "type": "integer", "description": "The status code, which should be an enum value of google.rpc.Code.", "format": "int32" }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array", "items": { "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } } } } }, "CancelOperationRequest": { "description": "The request message for Operations.CancelOperation.", "id": "CancelOperationRequest", "type": "object", "properties": {} }, "AllowlistedCertificate": { "id": "AllowlistedCertificate", "type": "object", "description": "Defines an allowlisted certificate.", "properties": { "pemCertificate": { "type": "string", "description": "Required. PEM certificate that is allowlisted. The certificate can be up to 5k bytes, and must be a parseable X.509 certificate." } } }, "UsedBy": { "properties": { "name": { "type": "string", "description": "Output only. Full name of the resource https://google.aip.dev/122#full-resource-names, e.g. `//certificatemanager.googleapis.com/projects/*/locations/*/certificateMaps/*/certificateMapEntries/*` or `//compute.googleapis.com/projects/*/locations/*/targetHttpsProxies/*`.", "readOnly": true } }, "id": "UsedBy", "type": "object", "description": "Defines a resource that uses the certificate." }, "ListTrustConfigsResponse": { "properties": { "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations that could not be reached." }, "trustConfigs": { "description": "A list of TrustConfigs for the parent resource.", "type": "array", "items": { "$ref": "TrustConfig" } }, "nextPageToken": { "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", "type": "string" } }, "description": "Response for the `ListTrustConfigs` method.", "id": "ListTrustConfigsResponse", "type": "object" }, "IPs": { "properties": { "resolved": { "description": "Output only. The list of IP addresses resolved from the domain's A/AAAA records. Can contain both ipv4 and ipv6 addresses.", "type": "array", "items": { "type": "string" }, "readOnly": true }, "serving": { "readOnly": true, "description": "Output only. The list of IP addresses, where the certificate is attached and port 443 is open.", "type": "array", "items": { "type": "string" } }, "servingOnAltPorts": { "type": "array", "items": { "type": "string" }, "description": "Output only. The list of IP addresses, where the certificate is attached, but port 443 is not open.", "readOnly": true } }, "description": "IPs troubleshooting information.", "id": "IPs", "type": "object" }, "CertificateMapEntry": { "description": "Defines a certificate map entry.", "id": "CertificateMapEntry", "type": "object", "properties": { "labels": { "description": "Optional. Set of labels associated with a Certificate Map Entry.", "type": "object", "additionalProperties": { "type": "string" } }, "matcher": { "enum": [ "MATCHER_UNSPECIFIED", "PRIMARY" ], "type": "string", "description": "A predefined matcher for particular cases, other than SNI selection.", "enumDescriptions": [ "A matcher has't been recognized.", "A primary certificate that is served when SNI wasn't specified in the request or SNI couldn't be found in the map." ] }, "certificates": { "description": "Optional. A set of Certificates defines for the given `hostname`. There can be defined up to four certificates in each Certificate Map Entry. Each certificate must match pattern `projects/*/locations/*/certificates/*`.", "type": "array", "items": { "type": "string" } }, "name": { "description": "Identifier. A user-defined name of the Certificate Map Entry. Certificate Map Entry names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", "type": "string" }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The creation timestamp of a Certificate Map Entry.", "type": "string" }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The update timestamp of a Certificate Map Entry.", "type": "string" }, "description": { "description": "Optional. One or more paragraphs of text description of a certificate map entry.", "type": "string" }, "hostname": { "description": "A Hostname (FQDN, e.g. `example.com`) or a wildcard hostname expression (`*.example.com`) for a set of hostnames with common suffix. Used as Server Name Indication (SNI) for selecting a proper certificate.", "type": "string" }, "state": { "readOnly": true, "description": "Output only. A serving state of this Certificate Map Entry.", "enumDescriptions": [ "The status is undefined.", "The configuration is serving.", "Update is in progress. Some frontends may serve this configuration." ], "type": "string", "enum": [ "SERVING_STATE_UNSPECIFIED", "ACTIVE", "PENDING" ] } } }, "ListCertificatesResponse": { "properties": { "certificates": { "type": "array", "items": { "$ref": "Certificate" }, "description": "A list of certificates for the parent resource." }, "unreachable": { "description": "A list of locations that could not be reached.", "type": "array", "items": { "type": "string" } }, "nextPageToken": { "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", "type": "string" } }, "description": "Response for the `ListCertificates` method.", "id": "ListCertificatesResponse", "type": "object" }, "SelfManagedCertificate": { "properties": { "pemCertificate": { "description": "Optional. Input only. The PEM-encoded certificate chain. Leaf certificate comes first, followed by intermediate ones if any.", "type": "string" }, "pemPrivateKey": { "description": "Optional. Input only. The PEM-encoded private key of the leaf certificate.", "type": "string" } }, "description": "Certificate data for a SelfManaged Certificate. SelfManaged Certificates are uploaded by the user. Updating such certificates before they expire remains the user's responsibility.", "id": "SelfManagedCertificate", "type": "object" }, "Certificate": { "description": "Defines TLS certificate.", "id": "Certificate", "type": "object", "properties": { "selfManaged": { "description": "If set, defines data of a self-managed certificate.", "$ref": "SelfManagedCertificate" }, "pemCertificate": { "description": "Output only. The PEM-encoded certificate chain.", "type": "string", "readOnly": true }, "scope": { "enum": [ "DEFAULT", "EDGE_CACHE", "ALL_REGIONS", "CLIENT_AUTH" ], "type": "string", "description": "Optional. Immutable. The scope of the certificate.", "enumDescriptions": [ "Use the DEFAULT scope if you plan to use the certificate with global external Application Load Balancer, global external proxy Network Load Balancer, or any of the regional Google Cloud services.", "Use the EDGE_CACHE scope if you plan to use the certificate with Media CDN. The certificates are served from Edge Points of Presence. See https://cloud.google.com/vpc/docs/edge-locations.", "Use the ALL_REGIONS scope if you plan to use the certificate with cross-region internal Application Load Balancer. The certificates are served from all Google Cloud regions. See https://cloud.google.com/compute/docs/regions-zones.", "Associated with certificates used as client certificates in Backend mTLS." ] }, "expireTime": { "type": "string", "description": "Output only. The expiry timestamp of a Certificate.", "readOnly": true, "format": "google-datetime" }, "createTime": { "description": "Output only. The creation timestamp of a Certificate.", "type": "string", "readOnly": true, "format": "google-datetime" }, "usedBy": { "readOnly": true, "description": "Output only. The list of resources that use this Certificate.", "type": "array", "items": { "$ref": "UsedBy" } }, "description": { "description": "Optional. One or more paragraphs of text description of a certificate.", "type": "string" }, "managed": { "description": "If set, contains configuration and state of a managed certificate.", "$ref": "ManagedCertificate" }, "managedIdentity": { "description": "If set, contains configuration and state of a managed identity certificate.", "$ref": "ManagedIdentityCertificate" }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. Set of labels associated with a Certificate.", "type": "object" }, "sanDnsnames": { "readOnly": true, "description": "Output only. The list of Subject Alternative Names of dnsName type defined in the certificate (see RFC 5280 4.2.1.6). Managed certificates that haven't been provisioned yet have this field populated with a value of the managed.domains field.", "type": "array", "items": { "type": "string" } }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The last update timestamp of a Certificate.", "type": "string" }, "name": { "type": "string", "description": "Identifier. A user-defined name of the certificate. Certificate names must be unique globally and match pattern `projects/*/locations/*/certificates/*`." } } }, "TrustConfig": { "properties": { "spiffeTrustStores": { "additionalProperties": { "$ref": "TrustStore" }, "description": "Optional. Defines a mapping from a trust domain to a TrustStore. This is used for SPIFFE certificate validation.", "type": "object" }, "labels": { "description": "Optional. Set of labels associated with a TrustConfig.", "type": "object", "additionalProperties": { "type": "string" } }, "trustStores": { "description": "Optional. Set of trust stores to perform validation against. This field is supported when TrustConfig is configured with Load Balancers, currently not supported for SPIFFE certificate validation. Only one TrustStore specified is currently allowed.", "type": "array", "items": { "$ref": "TrustStore" } }, "allowlistedCertificates": { "type": "array", "items": { "$ref": "AllowlistedCertificate" }, "description": "Optional. A certificate matching an allowlisted certificate is always considered valid as long as the certificate is parseable, proof of private key possession is established, and constraints on the certificate's SAN field are met." }, "name": { "type": "string", "description": "Identifier. A user-defined name of the trust config. TrustConfig names must be unique globally and match pattern `projects/*/locations/*/trustConfigs/*`." }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The creation timestamp of a TrustConfig.", "type": "string" }, "updateTime": { "type": "string", "description": "Output only. The last update timestamp of a TrustConfig.", "readOnly": true, "format": "google-datetime" }, "etag": { "type": "string", "description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding." }, "description": { "description": "Optional. One or more paragraphs of text description of a TrustConfig.", "type": "string" } }, "id": "TrustConfig", "type": "object", "description": "Defines a trust config." }, "GclbTarget": { "properties": { "targetHttpsProxy": { "description": "Output only. This field returns the resource name in the following format: `//compute.googleapis.com/projects/*/global/targetHttpsProxies/*`.", "type": "string", "readOnly": true }, "ipConfigs": { "readOnly": true, "description": "Output only. IP configurations for this Target Proxy where the Certificate Map is serving.", "type": "array", "items": { "$ref": "IpConfig" } }, "targetSslProxy": { "description": "Output only. This field returns the resource name in the following format: `//compute.googleapis.com/projects/*/global/targetSslProxies/*`.", "type": "string", "readOnly": true } }, "description": "Describes a Target Proxy that uses this Certificate Map.", "id": "GclbTarget", "type": "object" }, "Location": { "description": "A resource that represents a Google Cloud location.", "id": "Location", "type": "object", "properties": { "metadata": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object", "description": "Service-specific metadata. For example the available capacity at the given location." }, "name": { "type": "string", "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`" }, "labels": { "additionalProperties": { "type": "string" }, "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object" }, "locationId": { "type": "string", "description": "The canonical id for this location. For example: `\"us-east1\"`." }, "displayName": { "type": "string", "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\"." } } }, "ListCertificateIssuanceConfigsResponse": { "id": "ListCertificateIssuanceConfigsResponse", "type": "object", "description": "Response for the `ListCertificateIssuanceConfigs` method.", "properties": { "nextPageToken": { "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.", "type": "string" }, "certificateIssuanceConfigs": { "description": "A list of certificate configs for the parent resource.", "type": "array", "items": { "$ref": "CertificateIssuanceConfig" } }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "CertificateAuthorityConfig": { "properties": { "certificateAuthorityServiceConfig": { "description": "Defines a CertificateAuthorityServiceConfig.", "$ref": "CertificateAuthorityServiceConfig" } }, "description": "The CA that issues the workload certificate. It includes CA address, type, authentication to CA service, etc.", "id": "CertificateAuthorityConfig", "type": "object" }, "TrustStore": { "properties": { "trustAnchors": { "description": "Optional. List of Trust Anchors to be used while performing validation against a given TrustStore.", "type": "array", "items": { "$ref": "TrustAnchor" } }, "intermediateCas": { "description": "Optional. Set of intermediate CA certificates used for the path building phase of chain validation. The field is currently not supported if TrustConfig is used for the workload certificate feature.", "type": "array", "items": { "$ref": "IntermediateCA" } } }, "id": "TrustStore", "type": "object", "description": "Defines a trust store." }, "ListDnsAuthorizationsResponse": { "properties": { "nextPageToken": { "type": "string", "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`." }, "dnsAuthorizations": { "type": "array", "items": { "$ref": "DnsAuthorization" }, "description": "A list of dns authorizations for the parent resource." }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations that could not be reached." } }, "id": "ListDnsAuthorizationsResponse", "type": "object", "description": "Response for the `ListDnsAuthorizations` method." }, "IpConfig": { "description": "Defines IP configuration where this Certificate Map is serving.", "id": "IpConfig", "type": "object", "properties": { "ports": { "readOnly": true, "type": "array", "items": { "type": "integer", "format": "uint32" }, "description": "Output only. Ports." }, "ipAddress": { "readOnly": true, "description": "Output only. An external IP address.", "type": "string" } } }, "DnsAuthorization": { "properties": { "dnsResourceRecord": { "description": "Output only. DNS Resource Record that needs to be added to DNS configuration.", "$ref": "DnsResourceRecord", "readOnly": true }, "type": { "description": "Optional. Immutable. Type of DnsAuthorization. If unset during resource creation the following default will be used: - in location `global`: FIXED_RECORD, - in other locations: PER_PROJECT_RECORD.", "enumDescriptions": [ "Type is unspecified.", "FIXED_RECORD DNS authorization uses DNS-01 validation method.", "PER_PROJECT_RECORD DNS authorization allows for independent management of Google-managed certificates with DNS authorization across multiple projects." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "FIXED_RECORD", "PER_PROJECT_RECORD" ] }, "description": { "type": "string", "description": "Optional. One or more paragraphs of text description of a DnsAuthorization." }, "createTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The creation timestamp of a DnsAuthorization." }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The last update timestamp of a DnsAuthorization." }, "name": { "description": "Identifier. A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.", "type": "string" }, "labels": { "type": "object", "description": "Optional. Set of labels associated with a DnsAuthorization.", "additionalProperties": { "type": "string" } }, "domain": { "description": "Required. Immutable. A domain that is being authorized. A DnsAuthorization resource covers a single domain and its wildcard, e.g. authorization for `example.com` can be used to issue certificates for `example.com` and `*.example.com`.", "type": "string" } }, "description": "A DnsAuthorization resource describes a way to perform domain authorization for certificate issuance.", "id": "DnsAuthorization", "type": "object" }, "IntermediateCA": { "id": "IntermediateCA", "type": "object", "description": "Defines an intermediate CA.", "properties": { "pemCertificate": { "type": "string", "description": "PEM intermediate certificate used for building up paths for validation. Each certificate provided in PEM format may occupy up to 5kB." } } }, "OperationMetadata": { "id": "OperationMetadata", "type": "object", "description": "Represents the metadata of the long-running operation. Output only.", "properties": { "apiVersion": { "type": "string", "description": "API version used to start the operation." }, "endTime": { "format": "google-datetime", "description": "The time the operation finished running.", "type": "string" }, "statusMessage": { "description": "Human-readable status of the operation, if any.", "type": "string" }, "requestedCancellation": { "description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "type": "boolean" }, "target": { "description": "Server-defined resource path for the target of the operation.", "type": "string" }, "createTime": { "type": "string", "description": "The time the operation was created.", "format": "google-datetime" }, "verb": { "description": "Name of the verb executed by the operation.", "type": "string" } } }, "CertificateMap": { "properties": { "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. Set of labels associated with a Certificate Map." }, "name": { "type": "string", "description": "Identifier. A user-defined name of the Certificate Map. Certificate Map names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*`." }, "gclbTargets": { "readOnly": true, "description": "Output only. A list of GCLB targets that use this Certificate Map. A Target Proxy is only present on this list if it's attached to a Forwarding Rule.", "type": "array", "items": { "$ref": "GclbTarget" } }, "createTime": { "description": "Output only. The creation timestamp of a Certificate Map.", "type": "string", "readOnly": true, "format": "google-datetime" }, "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The update timestamp of a Certificate Map." }, "description": { "description": "Optional. One or more paragraphs of text description of a certificate map.", "type": "string" } }, "description": "Defines a collection of certificate configurations.", "id": "CertificateMap", "type": "object" }, "CNAME": { "properties": { "resolvedData": { "description": "Output only. The resolved CNAME chain. Empty list if the CNAME record for `CNAME.name` is not found. Otherwise the first item is the value of the CNAME record for `CNAME.name`. If the CNAME chain is longer, the second item is the value of the CNAME record for the first item, and so on.", "type": "array", "items": { "type": "string" }, "readOnly": true }, "name": { "readOnly": true, "description": "Output only. The name of the CNAME record for the domain, equals to `dns_resource_record.name` in the corresponding `DnsAuthorization`.", "type": "string" }, "expectedData": { "description": "Output only. The expected value of the CNAME record for the domain, equals to `dns_resource_record.data` in the corresponding `DnsAuthorization`.", "type": "string", "readOnly": true } }, "description": "CNAME troubleshooting information.", "id": "CNAME", "type": "object" }, "ListCertificateMapsResponse": { "properties": { "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } }, "certificateMaps": { "type": "array", "items": { "$ref": "CertificateMap" }, "description": "A list of certificate maps for the parent resource." }, "nextPageToken": { "type": "string", "description": "If there might be more results than those appearing in this response, then `next_page_token` is included. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`." } }, "description": "Response for the `ListCertificateMaps` method.", "id": "ListCertificateMapsResponse", "type": "object" } }, "revision": "20260405", "id": "certificatemanager:v1", "mtlsRootUrl": "https://certificatemanager.mtls.googleapis.com/", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "fullyEncodeReservedExpansion": true, "title": "Certificate Manager API", "rootUrl": "https://certificatemanager.googleapis.com/", "protocol": "rest", "documentationLink": "https://docs.cloud.google.com/certificate-manager/docs/overview", "ownerName": "Google", "basePath": "", "resources": { "projects": { "resources": { "locations": { "methods": { "list": { "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the [ListLocationsRequest.name] field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", "id": "certificatemanager.projects.locations.list", "response": { "$ref": "ListLocationsResponse" }, "path": "v1/{+name}/locations", "parameters": { "filter": { "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "type": "string", "location": "query" }, "name": { "description": "The resource that owns the locations collection, if applicable.", "type": "string", "required": true, "pattern": "^projects/[^/]+$", "location": "path" }, "pageToken": { "type": "string", "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query" }, "pageSize": { "description": "The maximum number of results to return. If not set, the service selects a default.", "type": "integer", "location": "query", "format": "int32" }, "extraLocationTypes": { "location": "query", "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", "repeated": true, "type": "string" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations" }, "get": { "id": "certificatemanager.projects.locations.get", "description": "Gets information about a location.", "response": { "$ref": "Location" }, "path": "v1/{+name}", "parameters": { "name": { "required": true, "description": "Resource name for the location.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}" } }, "resources": { "operations": { "methods": { "list": { "path": "v1/{+name}/operations", "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "returnPartialSuccess": { "location": "query", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "type": "boolean" }, "name": { "required": true, "type": "string", "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "pageSize": { "type": "integer", "description": "The standard list page size.", "location": "query", "format": "int32" } }, "parameterOrder": [ "name" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "id": "certificatemanager.projects.locations.operations.list", "response": { "$ref": "ListOperationsResponse" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "id": "certificatemanager.projects.locations.operations.delete", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "Empty" }, "path": "v1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "description": "The name of the operation resource to be deleted.", "type": "string" } }, "parameterOrder": [ "name" ] }, "get": { "parameters": { "name": { "required": true, "description": "The name of the operation resource.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "Operation" }, "id": "certificatemanager.projects.locations.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}:cancel", "parameters": { "name": { "type": "string", "description": "The name of the operation resource to be cancelled.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "id": "certificatemanager.projects.locations.operations.cancel", "request": { "$ref": "CancelOperationRequest" }, "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "Empty" } } } }, "certificates": { "methods": { "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificates/{certificatesId}", "response": { "$ref": "Certificate" }, "id": "certificatemanager.projects.locations.certificates.get", "description": "Gets details of a single Certificate.", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/certificates/[^/]+$", "location": "path", "type": "string", "description": "Required. A name of the certificate to describe. Must be in the format `projects/*/locations/*/certificates/*`.", "required": true } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "list": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificates", "response": { "$ref": "ListCertificatesResponse" }, "id": "certificatemanager.projects.locations.certificates.list", "description": "Lists Certificates in a given project and location.", "parameters": { "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "Optional. Maximum number of certificates to return per call." }, "pageToken": { "location": "query", "description": "Optional. The value returned by the last `ListCertificatesResponse`. Indicates that this is a continuation of a prior `ListCertificates` call, and that the system should return the next page of data.", "type": "string" }, "filter": { "type": "string", "description": "Optional. Filter expression to restrict the Certificates returned.", "location": "query" }, "orderBy": { "description": "Optional. A list of Certificate field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "type": "string", "location": "query" }, "parent": { "type": "string", "description": "Required. The project and location from which the certificate should be listed, specified in the format `projects/*/locations/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" } }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/certificates" }, "create": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificates", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/certificates", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The parent resource of the certificate. Must be in the format `projects/*/locations/*`." }, "certificateId": { "type": "string", "description": "Required. A user-provided name of the certificate.", "location": "query" } }, "parameterOrder": [ "parent" ], "description": "Creates a new Certificate in a given project and location.", "id": "certificatemanager.projects.locations.certificates.create", "request": { "$ref": "Certificate" }, "response": { "$ref": "Operation" } }, "patch": { "description": "Updates a Certificate.", "id": "certificatemanager.projects.locations.certificates.patch", "request": { "$ref": "Certificate" }, "response": { "$ref": "Operation" }, "path": "v1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/certificates/[^/]+$", "location": "path", "description": "Identifier. A user-defined name of the certificate. Certificate names must be unique globally and match pattern `projects/*/locations/*/certificates/*`.", "type": "string", "required": true }, "updateMask": { "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.", "type": "string", "location": "query", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificates/{certificatesId}" }, "delete": { "id": "certificatemanager.projects.locations.certificates.delete", "description": "Deletes a single Certificate.", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "parameters": { "name": { "required": true, "description": "Required. A name of the certificate to delete. Must be in the format `projects/*/locations/*/certificates/*`.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/certificates/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificates/{certificatesId}" } } }, "certificateIssuanceConfigs": { "methods": { "get": { "id": "certificatemanager.projects.locations.certificateIssuanceConfigs.get", "description": "Gets details of a single CertificateIssuanceConfig.", "response": { "$ref": "CertificateIssuanceConfig" }, "path": "v1/{+name}", "parameters": { "name": { "type": "string", "description": "Required. A name of the certificate issuance config to describe. Must be in the format `projects/*/locations/*/certificateIssuanceConfigs/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/certificateIssuanceConfigs/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateIssuanceConfigs/{certificateIssuanceConfigsId}" }, "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateIssuanceConfigs", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/certificateIssuanceConfigs", "parameters": { "pageToken": { "location": "query", "description": "Optional. The value returned by the last `ListCertificateIssuanceConfigsResponse`. Indicates that this is a continuation of a prior `ListCertificateIssuanceConfigs` call, and that the system should return the next page of data.", "type": "string" }, "filter": { "type": "string", "description": "Optional. Filter expression to restrict the Certificates Configs returned.", "location": "query" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "Optional. Maximum number of certificate configs to return per call." }, "orderBy": { "description": "Optional. A list of Certificate Config field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "type": "string", "location": "query" }, "parent": { "type": "string", "description": "Required. The project and location from which the certificate should be listed, specified in the format `projects/*/locations/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" } }, "parameterOrder": [ "parent" ], "description": "Lists CertificateIssuanceConfigs in a given project and location.", "id": "certificatemanager.projects.locations.certificateIssuanceConfigs.list", "response": { "$ref": "ListCertificateIssuanceConfigsResponse" } }, "create": { "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "description": "Required. The parent resource of the certificate issuance config. Must be in the format `projects/*/locations/*`.", "type": "string", "required": true }, "certificateIssuanceConfigId": { "location": "query", "type": "string", "description": "Required. A user-provided name of the certificate config." } }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/certificateIssuanceConfigs", "response": { "$ref": "Operation" }, "description": "Creates a new CertificateIssuanceConfig in a given project and location.", "id": "certificatemanager.projects.locations.certificateIssuanceConfigs.create", "request": { "$ref": "CertificateIssuanceConfig" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateIssuanceConfigs", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "parameters": { "name": { "description": "Identifier. A user-defined name of the certificate issuance config. CertificateIssuanceConfig names must be unique globally and match pattern `projects/*/locations/*/certificateIssuanceConfigs/*`.", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/certificateIssuanceConfigs/[^/]+$", "location": "path" }, "updateMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask." } }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "Operation" }, "id": "certificatemanager.projects.locations.certificateIssuanceConfigs.patch", "request": { "$ref": "CertificateIssuanceConfig" }, "description": "Updates a CertificateIssuanceConfig.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateIssuanceConfigs/{certificateIssuanceConfigsId}", "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateIssuanceConfigs/{certificateIssuanceConfigsId}", "response": { "$ref": "Operation" }, "id": "certificatemanager.projects.locations.certificateIssuanceConfigs.delete", "description": "Deletes a single CertificateIssuanceConfig.", "parameters": { "name": { "required": true, "description": "Required. A name of the certificate issuance config to delete. Must be in the format `projects/*/locations/*/certificateIssuanceConfigs/*`.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/certificateIssuanceConfigs/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" } } }, "trustConfigs": { "methods": { "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/trustConfigs/{trustConfigsId}", "response": { "$ref": "TrustConfig" }, "description": "Gets details of a single TrustConfig.", "id": "certificatemanager.projects.locations.trustConfigs.get", "parameters": { "name": { "type": "string", "description": "Required. A name of the TrustConfig to describe. Must be in the format `projects/*/locations/*/trustConfigs/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/trustConfigs/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "list": { "path": "v1/{+parent}/trustConfigs", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "description": "Required. The project and location from which the TrustConfigs should be listed, specified in the format `projects/*/locations/*`.", "type": "string", "required": true }, "orderBy": { "type": "string", "description": "Optional. A list of TrustConfig field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "Optional. Filter expression to restrict the TrustConfigs returned." }, "pageToken": { "description": "Optional. The value returned by the last `ListTrustConfigsResponse`. Indicates that this is a continuation of a prior `ListTrustConfigs` call, and that the system should return the next page of data.", "type": "string", "location": "query" }, "pageSize": { "type": "integer", "description": "Optional. Maximum number of TrustConfigs to return per call.", "location": "query", "format": "int32" } }, "parameterOrder": [ "parent" ], "id": "certificatemanager.projects.locations.trustConfigs.list", "description": "Lists TrustConfigs in a given project and location.", "response": { "$ref": "ListTrustConfigsResponse" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/trustConfigs", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/trustConfigs", "response": { "$ref": "Operation" }, "description": "Creates a new TrustConfig in a given project and location.", "id": "certificatemanager.projects.locations.trustConfigs.create", "request": { "$ref": "TrustConfig" }, "parameters": { "parent": { "type": "string", "description": "Required. The parent resource of the TrustConfig. Must be in the format `projects/*/locations/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" }, "trustConfigId": { "type": "string", "description": "Required. A user-provided name of the TrustConfig. Must match the regexp `[a-z0-9-]{1,63}`.", "location": "query" } }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/trustConfigs" }, "patch": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/trustConfigs/{trustConfigsId}", "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "parameters": { "name": { "description": "Identifier. A user-defined name of the trust config. TrustConfig names must be unique globally and match pattern `projects/*/locations/*/trustConfigs/*`.", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/trustConfigs/[^/]+$", "location": "path" }, "updateMask": { "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.", "type": "string", "location": "query", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "id": "certificatemanager.projects.locations.trustConfigs.patch", "request": { "$ref": "TrustConfig" }, "description": "Updates a TrustConfig.", "response": { "$ref": "Operation" } }, "delete": { "parameters": { "name": { "required": true, "description": "Required. A name of the TrustConfig to delete. Must be in the format `projects/*/locations/*/trustConfigs/*`.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/trustConfigs/[^/]+$", "location": "path" }, "etag": { "description": "Optional. The current etag of the TrustConfig. If an etag is provided and does not match the current etag of the resource, deletion will be blocked and an ABORTED error will be returned.", "type": "string", "location": "query" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "Operation" }, "id": "certificatemanager.projects.locations.trustConfigs.delete", "description": "Deletes a single TrustConfig.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/trustConfigs/{trustConfigsId}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "dnsAuthorizations": { "methods": { "get": { "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsAuthorizations/{dnsAuthorizationsId}", "description": "Gets details of a single DnsAuthorization.", "id": "certificatemanager.projects.locations.dnsAuthorizations.get", "response": { "$ref": "DnsAuthorization" }, "path": "v1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/dnsAuthorizations/[^/]+$", "location": "path", "required": true, "description": "Required. A name of the dns authorization to describe. Must be in the format `projects/*/locations/*/dnsAuthorizations/*`.", "type": "string" } }, "parameterOrder": [ "name" ] }, "list": { "description": "Lists DnsAuthorizations in a given project and location.", "id": "certificatemanager.projects.locations.dnsAuthorizations.list", "response": { "$ref": "ListDnsAuthorizationsResponse" }, "path": "v1/{+parent}/dnsAuthorizations", "parameters": { "filter": { "description": "Optional. Filter expression to restrict the Dns Authorizations returned.", "type": "string", "location": "query" }, "pageToken": { "location": "query", "description": "Optional. The value returned by the last `ListDnsAuthorizationsResponse`. Indicates that this is a continuation of a prior `ListDnsAuthorizations` call, and that the system should return the next page of data.", "type": "string" }, "pageSize": { "type": "integer", "description": "Optional. Maximum number of dns authorizations to return per call.", "location": "query", "format": "int32" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "type": "string", "description": "Required. The project and location from which the dns authorizations should be listed, specified in the format `projects/*/locations/*`.", "required": true }, "orderBy": { "location": "query", "type": "string", "description": "Optional. A list of Dns Authorization field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`." } }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsAuthorizations" }, "create": { "parameters": { "dnsAuthorizationId": { "location": "query", "description": "Required. A user-provided name of the dns authorization.", "type": "string" }, "parent": { "required": true, "description": "Required. The parent resource of the dns authorization. Must be in the format `projects/*/locations/*`.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" } }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/dnsAuthorizations", "response": { "$ref": "Operation" }, "id": "certificatemanager.projects.locations.dnsAuthorizations.create", "request": { "$ref": "DnsAuthorization" }, "description": "Creates a new DnsAuthorization in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsAuthorizations", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "id": "certificatemanager.projects.locations.dnsAuthorizations.patch", "request": { "$ref": "DnsAuthorization" }, "description": "Updates a DnsAuthorization.", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/dnsAuthorizations/[^/]+$", "location": "path", "description": "Identifier. A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.", "type": "string", "required": true }, "updateMask": { "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.", "type": "string", "location": "query", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsAuthorizations/{dnsAuthorizationsId}" }, "delete": { "path": "v1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/dnsAuthorizations/[^/]+$", "location": "path", "type": "string", "description": "Required. A name of the dns authorization to delete. Must be in the format `projects/*/locations/*/dnsAuthorizations/*`.", "required": true } }, "parameterOrder": [ "name" ], "description": "Deletes a single DnsAuthorization.", "id": "certificatemanager.projects.locations.dnsAuthorizations.delete", "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dnsAuthorizations/{dnsAuthorizationsId}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } }, "certificateMaps": { "methods": { "get": { "description": "Gets details of a single CertificateMap.", "id": "certificatemanager.projects.locations.certificateMaps.get", "response": { "$ref": "CertificateMap" }, "path": "v1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. A name of the certificate map to describe. Must be in the format `projects/*/locations/*/certificateMaps/*`." } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}" }, "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageSize": { "type": "integer", "description": "Optional. Maximum number of certificate maps to return per call.", "location": "query", "format": "int32" }, "pageToken": { "type": "string", "description": "Optional. The value returned by the last `ListCertificateMapsResponse`. Indicates that this is a continuation of a prior `ListCertificateMaps` call, and that the system should return the next page of data.", "location": "query" }, "filter": { "type": "string", "description": "Optional. Filter expression to restrict the Certificates Maps returned.", "location": "query" }, "orderBy": { "location": "query", "description": "Optional. A list of Certificate Map field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "type": "string" }, "parent": { "required": true, "type": "string", "description": "Required. The project and location from which the certificate maps should be listed, specified in the format `projects/*/locations/*`.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" } }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/certificateMaps", "response": { "$ref": "ListCertificateMapsResponse" }, "id": "certificatemanager.projects.locations.certificateMaps.list", "description": "Lists CertificateMaps in a given project and location." }, "create": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/certificateMaps", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "type": "string", "description": "Required. The parent resource of the certificate map. Must be in the format `projects/*/locations/*`.", "required": true }, "certificateMapId": { "type": "string", "description": "Required. A user-provided name of the certificate map.", "location": "query" } }, "parameterOrder": [ "parent" ], "id": "certificatemanager.projects.locations.certificateMaps.create", "request": { "$ref": "CertificateMap" }, "description": "Creates a new CertificateMap in a given project and location.", "response": { "$ref": "Operation" } }, "patch": { "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}", "response": { "$ref": "Operation" }, "description": "Updates a CertificateMap.", "id": "certificatemanager.projects.locations.certificateMaps.patch", "request": { "$ref": "CertificateMap" }, "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+$", "location": "path", "description": "Identifier. A user-defined name of the Certificate Map. Certificate Map names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*`.", "type": "string", "required": true }, "updateMask": { "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.", "type": "string", "location": "query", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}", "response": { "$ref": "Operation" }, "id": "certificatemanager.projects.locations.certificateMaps.delete", "description": "Deletes a single CertificateMap. A Certificate Map can't be deleted if it contains Certificate Map Entries. Remove all the entries from the map before calling this method.", "parameters": { "name": { "type": "string", "description": "Required. A name of the certificate map to delete. Must be in the format `projects/*/locations/*/certificateMaps/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" } }, "resources": { "certificateMapEntries": { "methods": { "list": { "response": { "$ref": "ListCertificateMapEntriesResponse" }, "id": "certificatemanager.projects.locations.certificateMaps.certificateMapEntries.list", "description": "Lists CertificateMapEntries in a given project and location.", "parameters": { "filter": { "type": "string", "description": "Optional. Filter expression to restrict the returned Certificate Map Entries.", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. The value returned by the last `ListCertificateMapEntriesResponse`. Indicates that this is a continuation of a prior `ListCertificateMapEntries` call, and that the system should return the next page of data.", "location": "query" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "Optional. Maximum number of certificate map entries to return. The service may return fewer than this value. If unspecified, at most 50 certificate map entries will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000." }, "parent": { "type": "string", "description": "Required. The project, location and certificate map from which the certificate map entries should be listed, specified in the format `projects/*/locations/*/certificateMaps/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+$", "location": "path" }, "orderBy": { "location": "query", "description": "Optional. A list of Certificate Map Entry field names used to specify the order of the returned results. The default sorting order is ascending. To specify descending order for a field, add a suffix `\" desc\"`.", "type": "string" } }, "parameterOrder": [ "parent" ], "path": "v1/{+parent}/certificateMapEntries", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}/certificateMapEntries" }, "create": { "path": "v1/{+parent}/certificateMapEntries", "parameters": { "parent": { "description": "Required. The parent resource of the certificate map entry. Must be in the format `projects/*/locations/*/certificateMaps/*`.", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+$", "location": "path" }, "certificateMapEntryId": { "location": "query", "type": "string", "description": "Required. A user-provided name of the certificate map entry." } }, "parameterOrder": [ "parent" ], "id": "certificatemanager.projects.locations.certificateMaps.certificateMapEntries.create", "request": { "$ref": "CertificateMapEntry" }, "description": "Creates a new CertificateMapEntry in a given project and location.", "response": { "$ref": "Operation" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}/certificateMapEntries", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "httpMethod": "PATCH", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}/certificateMapEntries/{certificateMapEntriesId}", "id": "certificatemanager.projects.locations.certificateMaps.certificateMapEntries.patch", "request": { "$ref": "CertificateMapEntry" }, "description": "Updates a CertificateMapEntry.", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "parameters": { "name": { "required": true, "type": "string", "description": "Identifier. A user-defined name of the Certificate Map Entry. Certificate Map Entry names must be unique globally and match pattern `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+/certificateMapEntries/[^/]+$", "location": "path" }, "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Required. The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask.", "type": "string" } }, "parameterOrder": [ "name" ] }, "delete": { "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}/certificateMapEntries/{certificateMapEntriesId}", "response": { "$ref": "Operation" }, "id": "certificatemanager.projects.locations.certificateMaps.certificateMapEntries.delete", "description": "Deletes a single CertificateMapEntry.", "parameters": { "name": { "description": "Required. A name of the certificate map entry to delete. Must be in the format `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+/certificateMapEntries/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "get": { "parameters": { "name": { "type": "string", "description": "Required. A name of the certificate map entry to describe. Must be in the format `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/certificateMaps/[^/]+/certificateMapEntries/[^/]+$", "location": "path" } }, "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "CertificateMapEntry" }, "id": "certificatemanager.projects.locations.certificateMaps.certificateMapEntries.get", "description": "Gets details of a single CertificateMapEntry.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/certificateMaps/{certificateMapsId}/certificateMapEntries/{certificateMapEntriesId}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } } } } } } } }, "batchPath": "batch", "ownerDomain": "google.com", "parameters": { "$.xgafv": { "type": "string", "description": "V1 error format.", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ], "location": "query" }, "callback": { "location": "query", "type": "string", "description": "JSONP" }, "access_token": { "location": "query", "description": "OAuth access token.", "type": "string" }, "fields": { "location": "query", "type": "string", "description": "Selector specifying which fields to include in a partial response." }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "alt": { "description": "Data format for response.", "default": "json", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "type": "string", "enum": [ "json", "media", "proto" ], "location": "query" }, "upload_protocol": { "location": "query", "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")." }, "key": { "location": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "type": "string" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "type": "string", "location": "query" }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." } }, "servicePath": "", "canonicalName": "Certificate Manager", "description": "", "kind": "discovery#restDescription", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "discoveryVersion": "v1", "name": "certificatemanager" }