@@ -46,15 +46,15 @@ option ruby_package = "Google::Cloud::CertificateManager::V1";
4646//
4747// The Certificates Manager service exposes the following resources:
4848//
49- // * `Certificate` which describes a single TLS certificate.
50- // * `CertificateMap` which describes a collection of certificates that can be
49+ // * `Certificate` that describes a single TLS certificate.
50+ // * `CertificateMap` that describes a collection of certificates that can be
5151// attached to a target resource.
52- // * `CertificateMapEntry` which describes a single configuration entry that
52+ // * `CertificateMapEntry` that describes a single configuration entry that
5353// consists of a SNI and a group of certificates. It's a subresource of
5454// CertificateMap.
5555//
5656// Certificate, CertificateMap and CertificateMapEntry IDs
57- // have to match "^ [a-z0-9-]{1,63}$" regexp, which means that
57+ // have to fully match the regexp ` [a-z0-9-]{1,63}`. In other words,
5858// - only lower case letters, digits, and hyphen are allowed
5959// - length of the resource ID has to be in [1,63] range.
6060//
@@ -794,7 +794,9 @@ message Certificate {
794794 // Certificate Manager provisions and renews Managed Certificates
795795 // automatically, for as long as it's authorized to do so.
796796 message ManagedCertificate {
797+ // State of the managed certificate resource.
797798 enum State {
799+ // State is unspecified.
798800 STATE_UNSPECIFIED = 0 ;
799801
800802 // Certificate Manager attempts to provision or renew the certificate.
@@ -815,7 +817,9 @@ message Certificate {
815817
816818 // Information about issues with provisioning a Managed Certificate.
817819 message ProvisioningIssue {
820+ // Reason for provisioning failures.
818821 enum Reason {
822+ // Reason is unspecified.
819823 REASON_UNSPECIFIED = 0 ;
820824
821825 // Certificate provisioning failed due to an issue with one or more of
@@ -841,7 +845,9 @@ message Certificate {
841845 // State of the latest attempt to authorize a domain for certificate
842846 // issuance.
843847 message AuthorizationAttemptInfo {
848+ // State of the domain for managed certificate issuance.
844849 enum State {
850+ // State is unspecified.
845851 STATE_UNSPECIFIED = 0 ;
846852
847853 // Certificate provisioning for this domain is under way. GCP will
@@ -857,7 +863,9 @@ message Certificate {
857863 FAILED = 7 ;
858864 }
859865
866+ // Reason for failure of the authorization attempt for the domain.
860867 enum FailureReason {
868+ // FailureReason is unspecified.
861869 FAILURE_REASON_UNSPECIFIED = 0 ;
862870
863871 // There was a problem with the user's DNS or load balancer
@@ -904,7 +912,7 @@ message Certificate {
904912 }
905913 ];
906914
907- // The resource name for a
915+ // Immutable. The resource name for a
908916 // [CertificateIssuanceConfig][google.cloud.certificatemanager.v1.CertificateIssuanceConfig]
909917 // used to configure private PKI certificates in the format
910918 // `projects/*/locations/*/certificateIssuanceConfigs/*`.
@@ -993,7 +1001,7 @@ message CertificateMap {
9931001 pattern : "projects/{project}/locations/{location}/certificateMaps/{certificate_map}"
9941002 };
9951003
996- // Describes a Target Proxy which uses this Certificate Map.
1004+ // Describes a Target Proxy that uses this Certificate Map.
9971005 message GclbTarget {
9981006 // Defines IP configuration where this Certificate Map is serving.
9991007 message IpConfig {
@@ -1042,7 +1050,7 @@ message CertificateMap {
10421050 // Set of labels associated with a Certificate Map.
10431051 map <string , string > labels = 3 ;
10441052
1045- // Output only. A list of GCLB targets which use this Certificate Map.
1053+ // Output only. A list of GCLB targets that use this Certificate Map.
10461054 // A Target Proxy is only present on this list if it's attached to a
10471055 // Forwarding Rule.
10481056 repeated GclbTarget gclb_targets = 4
@@ -1150,7 +1158,7 @@ message DnsAuthorization {
11501158 // One or more paragraphs of text description of a DnsAuthorization.
11511159 string description = 5 ;
11521160
1153- // Required. Immutable. A domain which is being authorized. A DnsAuthorization
1161+ // Required. Immutable. A domain that is being authorized. A DnsAuthorization
11541162 // resource covers a single domain and its wildcard, e.g. authorization for
11551163 // `example.com` can be used to issue certificates for `example.com` and
11561164 // `*.example.com`.
0 commit comments