diff --git a/CertificateManager/metadata/V1/CertificateIssuanceConfig.php b/CertificateManager/metadata/V1/CertificateIssuanceConfig.php
index 924deb6fdbb..942ab73cecd 100644
Binary files a/CertificateManager/metadata/V1/CertificateIssuanceConfig.php and b/CertificateManager/metadata/V1/CertificateIssuanceConfig.php differ
diff --git a/CertificateManager/metadata/V1/CertificateManager.php b/CertificateManager/metadata/V1/CertificateManager.php
index 5f63e977f71..ee2177fdd79 100644
Binary files a/CertificateManager/metadata/V1/CertificateManager.php and b/CertificateManager/metadata/V1/CertificateManager.php differ
diff --git a/CertificateManager/samples/V1/CertificateManagerClient/create_dns_authorization.php b/CertificateManager/samples/V1/CertificateManagerClient/create_dns_authorization.php
index fdfdd1911d4..924da713c22 100644
--- a/CertificateManager/samples/V1/CertificateManagerClient/create_dns_authorization.php
+++ b/CertificateManager/samples/V1/CertificateManagerClient/create_dns_authorization.php
@@ -36,7 +36,7 @@
* format `projects/*/locations/*`. Please see
* {@see CertificateManagerClient::locationName()} for help formatting this field.
* @param string $dnsAuthorizationId A user-provided name of the dns authorization.
- * @param string $dnsAuthorizationDomain Immutable. A domain which is being authorized. A DnsAuthorization
+ * @param string $dnsAuthorizationDomain 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`.
diff --git a/CertificateManager/samples/V1/CertificateManagerClient/update_dns_authorization.php b/CertificateManager/samples/V1/CertificateManagerClient/update_dns_authorization.php
index d4646077055..28e38a3b380 100644
--- a/CertificateManager/samples/V1/CertificateManagerClient/update_dns_authorization.php
+++ b/CertificateManager/samples/V1/CertificateManagerClient/update_dns_authorization.php
@@ -33,7 +33,7 @@
/**
* Updates a DnsAuthorization.
*
- * @param string $dnsAuthorizationDomain Immutable. A domain which is being authorized. A DnsAuthorization
+ * @param string $dnsAuthorizationDomain 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`.
diff --git a/CertificateManager/src/V1/Certificate/ManagedCertificate.php b/CertificateManager/src/V1/Certificate/ManagedCertificate.php
index 0222632a7ba..4c77fea6210 100644
--- a/CertificateManager/src/V1/Certificate/ManagedCertificate.php
+++ b/CertificateManager/src/V1/Certificate/ManagedCertificate.php
@@ -33,7 +33,7 @@ class ManagedCertificate extends \Google\Protobuf\Internal\Message
*/
private $dns_authorizations;
/**
- * The resource name for a
+ * Immutable. The resource name for a
* [CertificateIssuanceConfig][google.cloud.certificatemanager.v1.CertificateIssuanceConfig]
* used to configure private PKI certificates in the format
* `projects/*/locations/*/certificateIssuanceConfigs/*`.
@@ -79,7 +79,7 @@ class ManagedCertificate extends \Google\Protobuf\Internal\Message
* Immutable. Authorizations that will be used for performing domain
* authorization.
* @type string $issuance_config
- * The resource name for a
+ * Immutable. The resource name for a
* [CertificateIssuanceConfig][google.cloud.certificatemanager.v1.CertificateIssuanceConfig]
* used to configure private PKI certificates in the format
* `projects/*/locations/*/certificateIssuanceConfigs/*`.
@@ -160,7 +160,7 @@ public function setDnsAuthorizations($var)
}
/**
- * The resource name for a
+ * Immutable. The resource name for a
* [CertificateIssuanceConfig][google.cloud.certificatemanager.v1.CertificateIssuanceConfig]
* used to configure private PKI certificates in the format
* `projects/*/locations/*/certificateIssuanceConfigs/*`.
@@ -177,7 +177,7 @@ public function getIssuanceConfig()
}
/**
- * The resource name for a
+ * Immutable. The resource name for a
* [CertificateIssuanceConfig][google.cloud.certificatemanager.v1.CertificateIssuanceConfig]
* used to configure private PKI certificates in the format
* `projects/*/locations/*/certificateIssuanceConfigs/*`.
diff --git a/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/FailureReason.php b/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/FailureReason.php
index 133b1939296..14a6411a146 100644
--- a/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/FailureReason.php
+++ b/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/FailureReason.php
@@ -7,11 +7,15 @@
use UnexpectedValueException;
/**
+ * Reason for failure of the authorization attempt for the domain.
+ *
* Protobuf type google.cloud.certificatemanager.v1.Certificate.ManagedCertificate.AuthorizationAttemptInfo.FailureReason
*/
class FailureReason
{
/**
+ * FailureReason is unspecified.
+ *
* Generated from protobuf enum FAILURE_REASON_UNSPECIFIED = 0;
*/
const FAILURE_REASON_UNSPECIFIED = 0;
diff --git a/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/State.php b/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/State.php
index e6ebaa54183..28e62a38894 100644
--- a/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/State.php
+++ b/CertificateManager/src/V1/Certificate/ManagedCertificate/AuthorizationAttemptInfo/State.php
@@ -7,11 +7,15 @@
use UnexpectedValueException;
/**
+ * State of the domain for managed certificate issuance.
+ *
* Protobuf type google.cloud.certificatemanager.v1.Certificate.ManagedCertificate.AuthorizationAttemptInfo.State
*/
class State
{
/**
+ * State is unspecified.
+ *
* Generated from protobuf enum STATE_UNSPECIFIED = 0;
*/
const STATE_UNSPECIFIED = 0;
diff --git a/CertificateManager/src/V1/Certificate/ManagedCertificate/ProvisioningIssue/Reason.php b/CertificateManager/src/V1/Certificate/ManagedCertificate/ProvisioningIssue/Reason.php
index ea0ee095559..7c2754cda2b 100644
--- a/CertificateManager/src/V1/Certificate/ManagedCertificate/ProvisioningIssue/Reason.php
+++ b/CertificateManager/src/V1/Certificate/ManagedCertificate/ProvisioningIssue/Reason.php
@@ -7,11 +7,15 @@
use UnexpectedValueException;
/**
+ * Reason for provisioning failures.
+ *
* Protobuf type google.cloud.certificatemanager.v1.Certificate.ManagedCertificate.ProvisioningIssue.Reason
*/
class Reason
{
/**
+ * Reason is unspecified.
+ *
* Generated from protobuf enum REASON_UNSPECIFIED = 0;
*/
const REASON_UNSPECIFIED = 0;
diff --git a/CertificateManager/src/V1/Certificate/ManagedCertificate/State.php b/CertificateManager/src/V1/Certificate/ManagedCertificate/State.php
index 06ebcde58f3..41394253bec 100644
--- a/CertificateManager/src/V1/Certificate/ManagedCertificate/State.php
+++ b/CertificateManager/src/V1/Certificate/ManagedCertificate/State.php
@@ -7,11 +7,15 @@
use UnexpectedValueException;
/**
+ * State of the managed certificate resource.
+ *
* Protobuf type google.cloud.certificatemanager.v1.Certificate.ManagedCertificate.State
*/
class State
{
/**
+ * State is unspecified.
+ *
* Generated from protobuf enum STATE_UNSPECIFIED = 0;
*/
const STATE_UNSPECIFIED = 0;
diff --git a/CertificateManager/src/V1/CertificateManagerGrpcClient.php b/CertificateManager/src/V1/CertificateManagerGrpcClient.php
index 08b735aae99..fbcfa7d3536 100644
--- a/CertificateManager/src/V1/CertificateManagerGrpcClient.php
+++ b/CertificateManager/src/V1/CertificateManagerGrpcClient.php
@@ -32,15 +32,15 @@
*
* The Certificates Manager service exposes the following resources:
*
- * * `Certificate` which describes a single TLS certificate.
- * * `CertificateMap` which describes a collection of certificates that can be
+ * * `Certificate` that describes a single TLS certificate.
+ * * `CertificateMap` that describes a collection of certificates that can be
* attached to a target resource.
- * * `CertificateMapEntry` which describes a single configuration entry that
+ * * `CertificateMapEntry` that describes a single configuration entry that
* consists of a SNI and a group of certificates. It's a subresource of
* CertificateMap.
*
* Certificate, CertificateMap and CertificateMapEntry IDs
- * have to match "^[a-z0-9-]{1,63}$ regexp, which means that
+ * have to fully match the regexp `[a-z0-9-]{1,63}`. In other words,
* - only lower case letters, digits, and hyphen are allowed
* - length of the resource ID has to be in [1,63] range.
*
diff --git a/CertificateManager/src/V1/CertificateMap.php b/CertificateManager/src/V1/CertificateMap.php
index c4a44679e1f..7970a7c3844 100644
--- a/CertificateManager/src/V1/CertificateMap.php
+++ b/CertificateManager/src/V1/CertificateMap.php
@@ -48,7 +48,7 @@ class CertificateMap extends \Google\Protobuf\Internal\Message
*/
private $labels;
/**
- * Output only. A list of GCLB targets which use this Certificate Map.
+ * 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.
*
@@ -75,7 +75,7 @@ class CertificateMap extends \Google\Protobuf\Internal\Message
* @type array|\Google\Protobuf\Internal\MapField $labels
* Set of labels associated with a Certificate Map.
* @type array<\Google\Cloud\CertificateManager\V1\CertificateMap\GclbTarget>|\Google\Protobuf\Internal\RepeatedField $gclb_targets
- * Output only. A list of GCLB targets which use this Certificate Map.
+ * 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.
* }
@@ -240,7 +240,7 @@ public function setLabels($var)
}
/**
- * Output only. A list of GCLB targets which use this Certificate Map.
+ * 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.
*
@@ -253,7 +253,7 @@ public function getGclbTargets()
}
/**
- * Output only. A list of GCLB targets which use this Certificate Map.
+ * 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.
*
diff --git a/CertificateManager/src/V1/CertificateMap/GclbTarget.php b/CertificateManager/src/V1/CertificateMap/GclbTarget.php
index 9a5cc279021..64db84abc4a 100644
--- a/CertificateManager/src/V1/CertificateMap/GclbTarget.php
+++ b/CertificateManager/src/V1/CertificateMap/GclbTarget.php
@@ -9,7 +9,7 @@
use Google\Protobuf\Internal\GPBUtil;
/**
- * Describes a Target Proxy which uses this Certificate Map.
+ * Describes a Target Proxy that uses this Certificate Map.
*
* Generated from protobuf message google.cloud.certificatemanager.v1.CertificateMap.GclbTarget
*/
diff --git a/CertificateManager/src/V1/DnsAuthorization.php b/CertificateManager/src/V1/DnsAuthorization.php
index 600cdbdde52..d09bd94c71c 100644
--- a/CertificateManager/src/V1/DnsAuthorization.php
+++ b/CertificateManager/src/V1/DnsAuthorization.php
@@ -49,7 +49,7 @@ class DnsAuthorization extends \Google\Protobuf\Internal\Message
*/
private $description = '';
/**
- * Required. Immutable. A domain which is being authorized. A DnsAuthorization
+ * 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`.
@@ -84,7 +84,7 @@ class DnsAuthorization extends \Google\Protobuf\Internal\Message
* @type string $description
* One or more paragraphs of text description of a DnsAuthorization.
* @type string $domain
- * Required. Immutable. A domain which is being authorized. A DnsAuthorization
+ * 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`.
@@ -253,7 +253,7 @@ public function setDescription($var)
}
/**
- * Required. Immutable. A domain which is being authorized. A DnsAuthorization
+ * 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`.
@@ -267,7 +267,7 @@ public function getDomain()
}
/**
- * Required. Immutable. A domain which is being authorized. A DnsAuthorization
+ * 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`.
diff --git a/CertificateManager/src/V1/Gapic/CertificateManagerGapicClient.php b/CertificateManager/src/V1/Gapic/CertificateManagerGapicClient.php
index 6038b9a28c0..b038533a76c 100644
--- a/CertificateManager/src/V1/Gapic/CertificateManagerGapicClient.php
+++ b/CertificateManager/src/V1/Gapic/CertificateManagerGapicClient.php
@@ -91,15 +91,15 @@
*
* The Certificates Manager service exposes the following resources:
*
- * * `Certificate` which describes a single TLS certificate.
- * * `CertificateMap` which describes a collection of certificates that can be
+ * * `Certificate` that describes a single TLS certificate.
+ * * `CertificateMap` that describes a collection of certificates that can be
* attached to a target resource.
- * * `CertificateMapEntry` which describes a single configuration entry that
+ * * `CertificateMapEntry` that describes a single configuration entry that
* consists of a SNI and a group of certificates. It's a subresource of
* CertificateMap.
*
* Certificate, CertificateMap and CertificateMapEntry IDs
- * have to match "^[a-z0-9-]{1,63}$" regexp, which means that
+ * have to fully match the regexp `[a-z0-9-]{1,63}`. In other words,
* - only lower case letters, digits, and hyphen are allowed
* - length of the resource ID has to be in [1,63] range.
*