From 95ee84ad8bfbf36c6c1d27d476d2edd07605b362 Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Wed, 24 Aug 2022 22:49:09 -0700 Subject: [PATCH] feat: [ApigeeRegistry] added support for `force` field for API and API version deletion (#5460) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat: added support for `force` field for API and API version deletion docs: updated proto comments to align with the public documentation Clients can now set the `force` field while sending delete request to allow cascade deletion of resources in the registry. PiperOrigin-RevId: 468760464 Source-Link: https://github.com/googleapis/googleapis/commit/b965a25493252b21814d7ebe06572baf169efa97 Source-Link: https://github.com/googleapis/googleapis-gen/commit/918d6fd0fb5419ed91f679a1b4f8fc5ae51affb7 Copy-Tag: eyJwIjoiQXBpZ2VlUmVnaXN0cnkvLk93bEJvdC55YW1sIiwiaCI6IjkxOGQ2ZmQwZmI1NDE5ZWQ5MWY2NzlhMWI0ZjhmYzVhZTUxYWZmYjcifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Owl Bot --- .../metadata/V1/RegistryService.php | 12 +- ApigeeRegistry/src/V1/Api.php | 44 ++--- ApigeeRegistry/src/V1/ApiDeployment.php | 34 ++-- ApigeeRegistry/src/V1/ApiSpec.php | 28 +-- ApigeeRegistry/src/V1/ApiVersion.php | 18 +- ApigeeRegistry/src/V1/Artifact.php | 4 +- .../src/V1/CreateApiDeploymentRequest.php | 8 +- ApigeeRegistry/src/V1/CreateApiRequest.php | 24 +-- .../src/V1/CreateApiSpecRequest.php | 8 +- .../src/V1/CreateApiVersionRequest.php | 8 +- .../src/V1/CreateArtifactRequest.php | 8 +- .../src/V1/DeleteApiDeploymentRequest.php | 8 +- .../V1/DeleteApiDeploymentRevisionRequest.php | 8 +- ApigeeRegistry/src/V1/DeleteApiRequest.php | 46 ++++- .../src/V1/DeleteApiSpecRequest.php | 8 +- .../src/V1/DeleteApiSpecRevisionRequest.php | 8 +- .../src/V1/DeleteApiVersionRequest.php | 46 ++++- .../src/V1/DeleteArtifactRequest.php | 8 +- .../src/V1/Gapic/RegistryGapicClient.php | 172 ++++++++++-------- .../src/V1/GetApiDeploymentRequest.php | 8 +- ApigeeRegistry/src/V1/GetApiRequest.php | 8 +- .../src/V1/GetApiSpecContentsRequest.php | 8 +- ApigeeRegistry/src/V1/GetApiSpecRequest.php | 8 +- .../src/V1/GetApiVersionRequest.php | 8 +- .../src/V1/GetArtifactContentsRequest.php | 8 +- ApigeeRegistry/src/V1/GetArtifactRequest.php | 8 +- ApigeeRegistry/src/V1/Instance.php | 8 +- .../src/V1/ListApiDeploymentsRequest.php | 8 +- ApigeeRegistry/src/V1/ListApiSpecsRequest.php | 8 +- .../src/V1/ListApiVersionsRequest.php | 8 +- ApigeeRegistry/src/V1/ListApisRequest.php | 8 +- .../src/V1/ListArtifactsRequest.php | 8 +- ApigeeRegistry/src/V1/RegistryGrpcClient.php | 74 ++++---- .../src/V1/ReplaceArtifactRequest.php | 8 +- .../src/V1/RollbackApiDeploymentRequest.php | 8 +- .../src/V1/RollbackApiSpecRequest.php | 8 +- .../src/V1/UpdateApiDeploymentRequest.php | 24 +-- ApigeeRegistry/src/V1/UpdateApiRequest.php | 32 ++-- .../src/V1/UpdateApiSpecRequest.php | 24 +-- .../src/V1/UpdateApiVersionRequest.php | 24 +-- 40 files changed, 449 insertions(+), 357 deletions(-) diff --git a/ApigeeRegistry/metadata/V1/RegistryService.php b/ApigeeRegistry/metadata/V1/RegistryService.php index 1d39759a81de..771706b15dfc 100644 --- a/ApigeeRegistry/metadata/V1/RegistryService.php +++ b/ApigeeRegistry/metadata/V1/RegistryService.php @@ -24,7 +24,7 @@ public static function initOnce() { \GPBMetadata\Google\Protobuf\FieldMask::initOnce(); $pool->internalAddGeneratedFile( ' -Ör +ôr 5google/cloud/apigeeregistry/v1/registry_service.protogoogle.cloud.apigeeregistry.v1google/api/client.protogoogle/api/field_behavior.protogoogle/api/httpbody.protogoogle/api/resource.proto4google/cloud/apigeeregistry/v1/registry_models.protogoogle/protobuf/empty.proto google/protobuf/field_mask.proto"ƒ ListApisRequest9 parent ( B)àAúA#!apigeeregistry.googleapis.com/Api @@ -45,10 +45,11 @@ public static function initOnce() { UpdateApiRequest5 api ( 2#.google.cloud.apigeeregistry.v1.ApiBàA/ update_mask ( 2.google.protobuf.FieldMask - allow_missing ("K + allow_missing ("Z DeleteApiRequest7 name ( B)àAúA# -!apigeeregistry.googleapis.com/Api"‘ +!apigeeregistry.googleapis.com/Api +force ("‘ ListApiVersionsRequest@ parent ( B0àAúA*(apigeeregistry.googleapis.com/ApiVersion page_size ( @@ -68,10 +69,11 @@ public static function initOnce() { UpdateApiVersionRequestD api_version ( 2*.google.cloud.apigeeregistry.v1.ApiVersionBàA/ update_mask ( 2.google.protobuf.FieldMask - allow_missing ("Y + allow_missing ("h DeleteApiVersionRequest> name ( B0àAúA* -(apigeeregistry.googleapis.com/ApiVersion"‹ +(apigeeregistry.googleapis.com/ApiVersion +force ("‹ ListApiSpecsRequest= parent ( B-àAúA\'%apigeeregistry.googleapis.com/ApiSpec page_size ( diff --git a/ApigeeRegistry/src/V1/Api.php b/ApigeeRegistry/src/V1/Api.php index 96693a64701e..4bfc8dddc946 100644 --- a/ApigeeRegistry/src/V1/Api.php +++ b/ApigeeRegistry/src/V1/Api.php @@ -9,8 +9,8 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An Api is a top-level description of an API. - * Apis are produced by producers and are commitments to provide services. + * A top-level description of an API. + * Produced by producers and are commitments to provide services. * * Generated from protobuf message google.cloud.apigeeregistry.v1.Api */ @@ -49,21 +49,21 @@ class Api extends \Google\Protobuf\Internal\Message /** * A user-definable description of the availability of this service. * Format: free-form, but we expect single words that describe availability, - * e.g. "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". + * e.g., "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". * * Generated from protobuf field string availability = 6; */ private $availability = ''; /** * The recommended version of the API. - * Format: apis/{api}/versions/{version} + * Format: `apis/{api}/versions/{version}` * * Generated from protobuf field string recommended_version = 7 [(.google.api.resource_reference) = { */ private $recommended_version = ''; /** * The recommended deployment of the API. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * * Generated from protobuf field string recommended_deployment = 8 [(.google.api.resource_reference) = { */ @@ -73,12 +73,12 @@ class Api extends \Google\Protobuf\Internal\Message * be used to filter list operations. * Label keys and values can be no longer than 64 characters * (Unicode codepoints), can only contain lowercase letters, numeric - * characters, underscores and dashes. International characters are allowed. + * characters, underscores, and dashes. International characters are allowed. * No more than 64 user labels can be associated with one resource (System * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 9; */ @@ -112,24 +112,24 @@ class Api extends \Google\Protobuf\Internal\Message * @type string $availability * A user-definable description of the availability of this service. * Format: free-form, but we expect single words that describe availability, - * e.g. "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". + * e.g., "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". * @type string $recommended_version * The recommended version of the API. - * Format: apis/{api}/versions/{version} + * Format: `apis/{api}/versions/{version}` * @type string $recommended_deployment * The recommended deployment of the API. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * @type array|\Google\Protobuf\Internal\MapField $labels * Labels attach identifying metadata to resources. Identifying metadata can * be used to filter list operations. * Label keys and values can be no longer than 64 characters * (Unicode codepoints), can only contain lowercase letters, numeric - * characters, underscores and dashes. International characters are allowed. + * characters, underscores, and dashes. International characters are allowed. * No more than 64 user labels can be associated with one resource (System * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * @type array|\Google\Protobuf\Internal\MapField $annotations * Annotations attach non-identifying metadata to resources. * Annotation keys and values are less restricted than those of labels, but @@ -295,7 +295,7 @@ public function setUpdateTime($var) /** * A user-definable description of the availability of this service. * Format: free-form, but we expect single words that describe availability, - * e.g. "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". + * e.g., "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". * * Generated from protobuf field string availability = 6; * @return string @@ -308,7 +308,7 @@ public function getAvailability() /** * A user-definable description of the availability of this service. * Format: free-form, but we expect single words that describe availability, - * e.g. "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". + * e.g., "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN". * * Generated from protobuf field string availability = 6; * @param string $var @@ -324,7 +324,7 @@ public function setAvailability($var) /** * The recommended version of the API. - * Format: apis/{api}/versions/{version} + * Format: `apis/{api}/versions/{version}` * * Generated from protobuf field string recommended_version = 7 [(.google.api.resource_reference) = { * @return string @@ -336,7 +336,7 @@ public function getRecommendedVersion() /** * The recommended version of the API. - * Format: apis/{api}/versions/{version} + * Format: `apis/{api}/versions/{version}` * * Generated from protobuf field string recommended_version = 7 [(.google.api.resource_reference) = { * @param string $var @@ -352,7 +352,7 @@ public function setRecommendedVersion($var) /** * The recommended deployment of the API. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * * Generated from protobuf field string recommended_deployment = 8 [(.google.api.resource_reference) = { * @return string @@ -364,7 +364,7 @@ public function getRecommendedDeployment() /** * The recommended deployment of the API. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * * Generated from protobuf field string recommended_deployment = 8 [(.google.api.resource_reference) = { * @param string $var @@ -383,12 +383,12 @@ public function setRecommendedDeployment($var) * be used to filter list operations. * Label keys and values can be no longer than 64 characters * (Unicode codepoints), can only contain lowercase letters, numeric - * characters, underscores and dashes. International characters are allowed. + * characters, underscores, and dashes. International characters are allowed. * No more than 64 user labels can be associated with one resource (System * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 9; * @return \Google\Protobuf\Internal\MapField @@ -403,12 +403,12 @@ public function getLabels() * be used to filter list operations. * Label keys and values can be no longer than 64 characters * (Unicode codepoints), can only contain lowercase letters, numeric - * characters, underscores and dashes. International characters are allowed. + * characters, underscores, and dashes. International characters are allowed. * No more than 64 user labels can be associated with one resource (System * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 9; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/ApigeeRegistry/src/V1/ApiDeployment.php b/ApigeeRegistry/src/V1/ApiDeployment.php index 7ae18142c22c..346116bdd10a 100644 --- a/ApigeeRegistry/src/V1/ApiDeployment.php +++ b/ApigeeRegistry/src/V1/ApiDeployment.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An ApiDeployment describes a service running at particular address that + * Describes a service running at particular address that * provides a particular version of an API. ApiDeployments have revisions which * correspond to different configurations of a single deployment in time. * Revision identifiers should be updated whenever the served API spec or @@ -64,9 +64,9 @@ class ApiDeployment extends \Google\Protobuf\Internal\Message */ private $revision_update_time = null; /** - * The full resource name (including revision id) of the spec of the API being + * The full resource name (including revision ID) of the spec of the API being * served by the deployment. Changes to this value will update the revision. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * * Generated from protobuf field string api_spec_revision = 8 [(.google.api.resource_reference) = { */ @@ -79,7 +79,7 @@ class ApiDeployment extends \Google\Protobuf\Internal\Message */ private $endpoint_uri = ''; /** - * The address of the external channel of the API (e.g. the Developer + * The address of the external channel of the API (e.g., the Developer * Portal). Changes to this value will not affect the revision. * * Generated from protobuf field string external_channel_uri = 10; @@ -109,7 +109,7 @@ class ApiDeployment extends \Google\Protobuf\Internal\Message * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 14; */ @@ -147,14 +147,14 @@ class ApiDeployment extends \Google\Protobuf\Internal\Message * @type \Google\Protobuf\Timestamp $revision_update_time * Output only. Last update timestamp: when the represented revision was last modified. * @type string $api_spec_revision - * The full resource name (including revision id) of the spec of the API being + * The full resource name (including revision ID) of the spec of the API being * served by the deployment. Changes to this value will update the revision. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * @type string $endpoint_uri * The address where the deployment is serving. Changes to this value will * update the revision. * @type string $external_channel_uri - * The address of the external channel of the API (e.g. the Developer + * The address of the external channel of the API (e.g., the Developer * Portal). Changes to this value will not affect the revision. * @type string $intended_audience * Text briefly identifying the intended audience of the API. Changes to this @@ -172,7 +172,7 @@ class ApiDeployment extends \Google\Protobuf\Internal\Message * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * @type array|\Google\Protobuf\Internal\MapField $annotations * Annotations attach non-identifying metadata to resources. * Annotation keys and values are less restricted than those of labels, but @@ -402,9 +402,9 @@ public function setRevisionUpdateTime($var) } /** - * The full resource name (including revision id) of the spec of the API being + * The full resource name (including revision ID) of the spec of the API being * served by the deployment. Changes to this value will update the revision. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * * Generated from protobuf field string api_spec_revision = 8 [(.google.api.resource_reference) = { * @return string @@ -415,9 +415,9 @@ public function getApiSpecRevision() } /** - * The full resource name (including revision id) of the spec of the API being + * The full resource name (including revision ID) of the spec of the API being * served by the deployment. Changes to this value will update the revision. - * Format: apis/{api}/deployments/{deployment} + * Format: `apis/{api}/deployments/{deployment}` * * Generated from protobuf field string api_spec_revision = 8 [(.google.api.resource_reference) = { * @param string $var @@ -460,7 +460,7 @@ public function setEndpointUri($var) } /** - * The address of the external channel of the API (e.g. the Developer + * The address of the external channel of the API (e.g., the Developer * Portal). Changes to this value will not affect the revision. * * Generated from protobuf field string external_channel_uri = 10; @@ -472,7 +472,7 @@ public function getExternalChannelUri() } /** - * The address of the external channel of the API (e.g. the Developer + * The address of the external channel of the API (e.g., the Developer * Portal). Changes to this value will not affect the revision. * * Generated from protobuf field string external_channel_uri = 10; @@ -553,7 +553,7 @@ public function setAccessGuidance($var) * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 14; * @return \Google\Protobuf\Internal\MapField @@ -573,7 +573,7 @@ public function getLabels() * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 14; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/ApigeeRegistry/src/V1/ApiSpec.php b/ApigeeRegistry/src/V1/ApiSpec.php index 41465460cf49..1c6fbd327ff3 100644 --- a/ApigeeRegistry/src/V1/ApiSpec.php +++ b/ApigeeRegistry/src/V1/ApiSpec.php @@ -9,11 +9,11 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An ApiSpec describes a version of an API in a structured way. + * Describes a version of an API in a structured way. * ApiSpecs provide formal descriptions that consumers can use to use a version. * ApiSpec resources are intended to be fully-resolved descriptions of an * ApiVersion. When specs consist of multiple files, these should be bundled - * together (e.g. in a zip archive) and stored as a unit. Multiple specs can + * together (e.g., in a zip archive) and stored as a unit. Multiple specs can * exist to provide representations in different API description formats. * Synchronization of these representations would be provided by tooling and * background services. @@ -69,8 +69,8 @@ class ApiSpec extends \Google\Protobuf\Internal\Message /** * A style (format) descriptor for this spec that is specified as a Media Type * (https://en.wikipedia.org/wiki/Media_type). Possible values include - * "application/vnd.apigee.proto", "application/vnd.apigee.openapi", and - * "application/vnd.apigee.graphql", with possible suffixes representing + * `application/vnd.apigee.proto`, `application/vnd.apigee.openapi`, and + * `application/vnd.apigee.graphql`, with possible suffixes representing * compression types. These hypothetical names are defined in the vendor tree * defined in RFC6838 (https://tools.ietf.org/html/rfc6838) and are not final. * Content types can specify compression. Currently only GZip compression is @@ -120,7 +120,7 @@ class ApiSpec extends \Google\Protobuf\Internal\Message * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 14; */ @@ -160,8 +160,8 @@ class ApiSpec extends \Google\Protobuf\Internal\Message * @type string $mime_type * A style (format) descriptor for this spec that is specified as a Media Type * (https://en.wikipedia.org/wiki/Media_type). Possible values include - * "application/vnd.apigee.proto", "application/vnd.apigee.openapi", and - * "application/vnd.apigee.graphql", with possible suffixes representing + * `application/vnd.apigee.proto`, `application/vnd.apigee.openapi`, and + * `application/vnd.apigee.graphql`, with possible suffixes representing * compression types. These hypothetical names are defined in the vendor tree * defined in RFC6838 (https://tools.ietf.org/html/rfc6838) and are not final. * Content types can specify compression. Currently only GZip compression is @@ -191,7 +191,7 @@ class ApiSpec extends \Google\Protobuf\Internal\Message * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * @type array|\Google\Protobuf\Internal\MapField $annotations * Annotations attach non-identifying metadata to resources. * Annotation keys and values are less restricted than those of labels, but @@ -423,8 +423,8 @@ public function setRevisionUpdateTime($var) /** * A style (format) descriptor for this spec that is specified as a Media Type * (https://en.wikipedia.org/wiki/Media_type). Possible values include - * "application/vnd.apigee.proto", "application/vnd.apigee.openapi", and - * "application/vnd.apigee.graphql", with possible suffixes representing + * `application/vnd.apigee.proto`, `application/vnd.apigee.openapi`, and + * `application/vnd.apigee.graphql`, with possible suffixes representing * compression types. These hypothetical names are defined in the vendor tree * defined in RFC6838 (https://tools.ietf.org/html/rfc6838) and are not final. * Content types can specify compression. Currently only GZip compression is @@ -441,8 +441,8 @@ public function getMimeType() /** * A style (format) descriptor for this spec that is specified as a Media Type * (https://en.wikipedia.org/wiki/Media_type). Possible values include - * "application/vnd.apigee.proto", "application/vnd.apigee.openapi", and - * "application/vnd.apigee.graphql", with possible suffixes representing + * `application/vnd.apigee.proto`, `application/vnd.apigee.openapi`, and + * `application/vnd.apigee.graphql`, with possible suffixes representing * compression types. These hypothetical names are defined in the vendor tree * defined in RFC6838 (https://tools.ietf.org/html/rfc6838) and are not final. * Content types can specify compression. Currently only GZip compression is @@ -588,7 +588,7 @@ public function setContents($var) * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 14; * @return \Google\Protobuf\Internal\MapField @@ -608,7 +608,7 @@ public function getLabels() * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 14; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/ApigeeRegistry/src/V1/ApiVersion.php b/ApigeeRegistry/src/V1/ApiVersion.php index f17ba611e3ee..f3932060d599 100644 --- a/ApigeeRegistry/src/V1/ApiVersion.php +++ b/ApigeeRegistry/src/V1/ApiVersion.php @@ -9,7 +9,7 @@ use Google\Protobuf\Internal\GPBUtil; /** - * An ApiVersion describes a particular version of an API. + * Describes a particular version of an API. * ApiVersions are what consumers actually use. * * Generated from protobuf message google.cloud.apigeeregistry.v1.ApiVersion @@ -49,7 +49,7 @@ class ApiVersion extends \Google\Protobuf\Internal\Message /** * A user-definable description of the lifecycle phase of this API version. * Format: free-form, but we expect single words that describe API maturity, - * e.g. "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", + * e.g., "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", * "DEPRECATED", "RETIRED". * * Generated from protobuf field string state = 6; @@ -65,7 +65,7 @@ class ApiVersion extends \Google\Protobuf\Internal\Message * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 7; */ @@ -99,7 +99,7 @@ class ApiVersion extends \Google\Protobuf\Internal\Message * @type string $state * A user-definable description of the lifecycle phase of this API version. * Format: free-form, but we expect single words that describe API maturity, - * e.g. "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", + * e.g., "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", * "DEPRECATED", "RETIRED". * @type array|\Google\Protobuf\Internal\MapField $labels * Labels attach identifying metadata to resources. Identifying metadata can @@ -111,7 +111,7 @@ class ApiVersion extends \Google\Protobuf\Internal\Message * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * @type array|\Google\Protobuf\Internal\MapField $annotations * Annotations attach non-identifying metadata to resources. * Annotation keys and values are less restricted than those of labels, but @@ -277,7 +277,7 @@ public function setUpdateTime($var) /** * A user-definable description of the lifecycle phase of this API version. * Format: free-form, but we expect single words that describe API maturity, - * e.g. "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", + * e.g., "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", * "DEPRECATED", "RETIRED". * * Generated from protobuf field string state = 6; @@ -291,7 +291,7 @@ public function getState() /** * A user-definable description of the lifecycle phase of this API version. * Format: free-form, but we expect single words that describe API maturity, - * e.g. "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", + * e.g., "CONCEPT", "DESIGN", "DEVELOPMENT", "STAGING", "PRODUCTION", * "DEPRECATED", "RETIRED". * * Generated from protobuf field string state = 6; @@ -316,7 +316,7 @@ public function setState($var) * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 7; * @return \Google\Protobuf\Internal\MapField @@ -336,7 +336,7 @@ public function getLabels() * labels are excluded). * See https://goo.gl/xmQnxf for more information and examples of labels. * System reserved label keys are prefixed with - * "apigeeregistry.googleapis.com/" and cannot be changed. + * `apigeeregistry.googleapis.com/` and cannot be changed. * * Generated from protobuf field map labels = 7; * @param array|\Google\Protobuf\Internal\MapField $var diff --git a/ApigeeRegistry/src/V1/Artifact.php b/ApigeeRegistry/src/V1/Artifact.php index 61ee53e693b2..8a7013a39727 100644 --- a/ApigeeRegistry/src/V1/Artifact.php +++ b/ApigeeRegistry/src/V1/Artifact.php @@ -13,8 +13,8 @@ * and are used to store metadata that is too large or numerous to be stored * directly on the resource. Since artifacts are stored separately from parent * resources, they should generally be used for metadata that is needed - * infrequently, i.e. not for display in primary views of the resource but - * perhaps displayed or downloaded upon request. The ListArtifacts method + * infrequently, i.e., not for display in primary views of the resource but + * perhaps displayed or downloaded upon request. The `ListArtifacts` method * allows artifacts to be quickly enumerated and checked for presence without * downloading their (potentially-large) contents. * diff --git a/ApigeeRegistry/src/V1/CreateApiDeploymentRequest.php b/ApigeeRegistry/src/V1/CreateApiDeploymentRequest.php index e5b0252b8238..7ba51382ffd6 100644 --- a/ApigeeRegistry/src/V1/CreateApiDeploymentRequest.php +++ b/ApigeeRegistry/src/V1/CreateApiDeploymentRequest.php @@ -17,7 +17,7 @@ class CreateApiDeploymentRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -47,7 +47,7 @@ class CreateApiDeploymentRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @type \Google\Cloud\ApigeeRegistry\V1\ApiDeployment $api_deployment * Required. The deployment to create. * @type string $api_deployment_id @@ -65,7 +65,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -77,7 +77,7 @@ public function getParent() /** * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/CreateApiRequest.php b/ApigeeRegistry/src/V1/CreateApiRequest.php index cac712f476ab..34aa4078f26d 100644 --- a/ApigeeRegistry/src/V1/CreateApiRequest.php +++ b/ApigeeRegistry/src/V1/CreateApiRequest.php @@ -17,7 +17,7 @@ class CreateApiRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -29,8 +29,8 @@ class CreateApiRequest extends \Google\Protobuf\Internal\Message */ private $api = null; /** - * Required. The ID to use for the api, which will become the final component of - * the api's resource name. + * Required. The ID to use for the API, which will become the final component of + * the API's resource name. * This value should be 4-63 characters, and valid characters * are /[a-z][0-9]-/. * Following AIP-162, IDs must not have the form of a UUID. @@ -47,12 +47,12 @@ class CreateApiRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * @type \Google\Cloud\ApigeeRegistry\V1\Api $api * Required. The API to create. * @type string $api_id - * Required. The ID to use for the api, which will become the final component of - * the api's resource name. + * Required. The ID to use for the API, which will become the final component of + * the API's resource name. * This value should be 4-63 characters, and valid characters * are /[a-z][0-9]-/. * Following AIP-162, IDs must not have the form of a UUID. @@ -65,7 +65,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -77,7 +77,7 @@ public function getParent() /** * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var @@ -128,8 +128,8 @@ public function setApi($var) } /** - * Required. The ID to use for the api, which will become the final component of - * the api's resource name. + * Required. The ID to use for the API, which will become the final component of + * the API's resource name. * This value should be 4-63 characters, and valid characters * are /[a-z][0-9]-/. * Following AIP-162, IDs must not have the form of a UUID. @@ -143,8 +143,8 @@ public function getApiId() } /** - * Required. The ID to use for the api, which will become the final component of - * the api's resource name. + * Required. The ID to use for the API, which will become the final component of + * the API's resource name. * This value should be 4-63 characters, and valid characters * are /[a-z][0-9]-/. * Following AIP-162, IDs must not have the form of a UUID. diff --git a/ApigeeRegistry/src/V1/CreateApiSpecRequest.php b/ApigeeRegistry/src/V1/CreateApiSpecRequest.php index 32b0402c60de..cab89587448c 100644 --- a/ApigeeRegistry/src/V1/CreateApiSpecRequest.php +++ b/ApigeeRegistry/src/V1/CreateApiSpecRequest.php @@ -17,7 +17,7 @@ class CreateApiSpecRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -47,7 +47,7 @@ class CreateApiSpecRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @type \Google\Cloud\ApigeeRegistry\V1\ApiSpec $api_spec * Required. The spec to create. * @type string $api_spec_id @@ -65,7 +65,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -77,7 +77,7 @@ public function getParent() /** * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/CreateApiVersionRequest.php b/ApigeeRegistry/src/V1/CreateApiVersionRequest.php index 516a58622972..b4253766319f 100644 --- a/ApigeeRegistry/src/V1/CreateApiVersionRequest.php +++ b/ApigeeRegistry/src/V1/CreateApiVersionRequest.php @@ -17,7 +17,7 @@ class CreateApiVersionRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -47,7 +47,7 @@ class CreateApiVersionRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @type \Google\Cloud\ApigeeRegistry\V1\ApiVersion $api_version * Required. The version to create. * @type string $api_version_id @@ -65,7 +65,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -77,7 +77,7 @@ public function getParent() /** * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/CreateArtifactRequest.php b/ApigeeRegistry/src/V1/CreateArtifactRequest.php index dac87f2b9986..8c83a63f7f0d 100644 --- a/ApigeeRegistry/src/V1/CreateArtifactRequest.php +++ b/ApigeeRegistry/src/V1/CreateArtifactRequest.php @@ -17,7 +17,7 @@ class CreateArtifactRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -47,7 +47,7 @@ class CreateArtifactRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * @type \Google\Cloud\ApigeeRegistry\V1\Artifact $artifact * Required. The artifact to create. * @type string $artifact_id @@ -65,7 +65,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -77,7 +77,7 @@ public function getParent() /** * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/DeleteApiDeploymentRequest.php b/ApigeeRegistry/src/V1/DeleteApiDeploymentRequest.php index be494ed12e5e..ebb040f9121a 100644 --- a/ApigeeRegistry/src/V1/DeleteApiDeploymentRequest.php +++ b/ApigeeRegistry/src/V1/DeleteApiDeploymentRequest.php @@ -17,7 +17,7 @@ class DeleteApiDeploymentRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the deployment to delete. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -38,7 +38,7 @@ class DeleteApiDeploymentRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the deployment to delete. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * @type bool $force * If set to true, any child resources will also be deleted. * (Otherwise, the request will only work if there are no child resources.) @@ -51,7 +51,7 @@ public function __construct($data = NULL) { /** * Required. The name of the deployment to delete. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -63,7 +63,7 @@ public function getName() /** * Required. The name of the deployment to delete. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/DeleteApiDeploymentRevisionRequest.php b/ApigeeRegistry/src/V1/DeleteApiDeploymentRevisionRequest.php index 3ae07a9b0f2a..c3fa13e7611b 100644 --- a/ApigeeRegistry/src/V1/DeleteApiDeploymentRevisionRequest.php +++ b/ApigeeRegistry/src/V1/DeleteApiDeploymentRevisionRequest.php @@ -19,7 +19,7 @@ class DeleteApiDeploymentRevisionRequest extends \Google\Protobuf\Internal\Messa * Required. The name of the deployment revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -35,7 +35,7 @@ class DeleteApiDeploymentRevisionRequest extends \Google\Protobuf\Internal\Messa * Required. The name of the deployment revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8` * } */ public function __construct($data = NULL) { @@ -47,7 +47,7 @@ public function __construct($data = NULL) { * Required. The name of the deployment revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -61,7 +61,7 @@ public function getName() * Required. The name of the deployment revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/DeleteApiRequest.php b/ApigeeRegistry/src/V1/DeleteApiRequest.php index 6bcb99b9f246..65ff1d99bc67 100644 --- a/ApigeeRegistry/src/V1/DeleteApiRequest.php +++ b/ApigeeRegistry/src/V1/DeleteApiRequest.php @@ -17,11 +17,18 @@ class DeleteApiRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the API to delete. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ private $name = ''; + /** + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) + * + * Generated from protobuf field bool force = 2; + */ + private $force = false; /** * Constructor. @@ -31,7 +38,10 @@ class DeleteApiRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the API to delete. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` + * @type bool $force + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) * } */ public function __construct($data = NULL) { @@ -41,7 +51,7 @@ public function __construct($data = NULL) { /** * Required. The name of the API to delete. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +63,7 @@ public function getName() /** * Required. The name of the API to delete. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var @@ -67,5 +77,33 @@ public function setName($var) return $this; } + /** + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) + * + * Generated from protobuf field bool force = 2; + * @return bool + */ + public function getForce() + { + return $this->force; + } + + /** + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) + * + * Generated from protobuf field bool force = 2; + * @param bool $var + * @return $this + */ + public function setForce($var) + { + GPBUtil::checkBool($var); + $this->force = $var; + + return $this; + } + } diff --git a/ApigeeRegistry/src/V1/DeleteApiSpecRequest.php b/ApigeeRegistry/src/V1/DeleteApiSpecRequest.php index ed1bcfb36ace..92a0d83f8ffd 100644 --- a/ApigeeRegistry/src/V1/DeleteApiSpecRequest.php +++ b/ApigeeRegistry/src/V1/DeleteApiSpecRequest.php @@ -17,7 +17,7 @@ class DeleteApiSpecRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the spec to delete. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -38,7 +38,7 @@ class DeleteApiSpecRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the spec to delete. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * @type bool $force * If set to true, any child resources will also be deleted. * (Otherwise, the request will only work if there are no child resources.) @@ -51,7 +51,7 @@ public function __construct($data = NULL) { /** * Required. The name of the spec to delete. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -63,7 +63,7 @@ public function getName() /** * Required. The name of the spec to delete. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/DeleteApiSpecRevisionRequest.php b/ApigeeRegistry/src/V1/DeleteApiSpecRevisionRequest.php index c3471a64e780..0e0a87a5287c 100644 --- a/ApigeeRegistry/src/V1/DeleteApiSpecRevisionRequest.php +++ b/ApigeeRegistry/src/V1/DeleteApiSpecRevisionRequest.php @@ -19,7 +19,7 @@ class DeleteApiSpecRevisionRequest extends \Google\Protobuf\Internal\Message * Required. The name of the spec revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -35,7 +35,7 @@ class DeleteApiSpecRevisionRequest extends \Google\Protobuf\Internal\Message * Required. The name of the spec revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8` * } */ public function __construct($data = NULL) { @@ -47,7 +47,7 @@ public function __construct($data = NULL) { * Required. The name of the spec revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -61,7 +61,7 @@ public function getName() * Required. The name of the spec revision to be deleted, * with a revision ID explicitly included. * Example: - * projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/DeleteApiVersionRequest.php b/ApigeeRegistry/src/V1/DeleteApiVersionRequest.php index 3607e6d9e997..a217ebd1d9de 100644 --- a/ApigeeRegistry/src/V1/DeleteApiVersionRequest.php +++ b/ApigeeRegistry/src/V1/DeleteApiVersionRequest.php @@ -17,11 +17,18 @@ class DeleteApiVersionRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the version to delete. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ private $name = ''; + /** + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) + * + * Generated from protobuf field bool force = 2; + */ + private $force = false; /** * Constructor. @@ -31,7 +38,10 @@ class DeleteApiVersionRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the version to delete. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` + * @type bool $force + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) * } */ public function __construct($data = NULL) { @@ -41,7 +51,7 @@ public function __construct($data = NULL) { /** * Required. The name of the version to delete. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +63,7 @@ public function getName() /** * Required. The name of the version to delete. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var @@ -67,5 +77,33 @@ public function setName($var) return $this; } + /** + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) + * + * Generated from protobuf field bool force = 2; + * @return bool + */ + public function getForce() + { + return $this->force; + } + + /** + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) + * + * Generated from protobuf field bool force = 2; + * @param bool $var + * @return $this + */ + public function setForce($var) + { + GPBUtil::checkBool($var); + $this->force = $var; + + return $this; + } + } diff --git a/ApigeeRegistry/src/V1/DeleteArtifactRequest.php b/ApigeeRegistry/src/V1/DeleteArtifactRequest.php index 36a476f33391..49372d74c175 100644 --- a/ApigeeRegistry/src/V1/DeleteArtifactRequest.php +++ b/ApigeeRegistry/src/V1/DeleteArtifactRequest.php @@ -17,7 +17,7 @@ class DeleteArtifactRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the artifact to delete. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class DeleteArtifactRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the artifact to delete. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the artifact to delete. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the artifact to delete. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/Gapic/RegistryGapicClient.php b/ApigeeRegistry/src/V1/Gapic/RegistryGapicClient.php index 1a9c900f951c..e0a66ad6f35c 100644 --- a/ApigeeRegistry/src/V1/Gapic/RegistryGapicClient.php +++ b/ApigeeRegistry/src/V1/Gapic/RegistryGapicClient.php @@ -729,7 +729,7 @@ public function __construct(array $options = []) } /** - * CreateApi creates a specified API. + * Creates a specified API. * * Sample code: * ``` @@ -745,10 +745,10 @@ public function __construct(array $options = []) * ``` * * @param string $parent Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * @param Api $api Required. The API to create. - * @param string $apiId Required. The ID to use for the api, which will become the final component of - * the api's resource name. + * @param string $apiId Required. The ID to use for the API, which will become the final component of + * the API's resource name. * * This value should be 4-63 characters, and valid characters * are /[a-z][0-9]-/. @@ -790,7 +790,7 @@ public function createApi($parent, $api, $apiId, array $optionalArgs = []) } /** - * CreateApiDeployment creates a specified deployment. + * Creates a specified deployment. * * Sample code: * ``` @@ -806,7 +806,7 @@ public function createApi($parent, $api, $apiId, array $optionalArgs = []) * ``` * * @param string $parent Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @param ApiDeployment $apiDeployment Required. The deployment to create. * @param string $apiDeploymentId Required. The ID to use for the deployment, which will become the final component of * the deployment's resource name. @@ -855,7 +855,7 @@ public function createApiDeployment( } /** - * CreateApiSpec creates a specified spec. + * Creates a specified spec. * * Sample code: * ``` @@ -871,7 +871,7 @@ public function createApiDeployment( * ``` * * @param string $parent Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @param ApiSpec $apiSpec Required. The spec to create. * @param string $apiSpecId Required. The ID to use for the spec, which will become the final component of * the spec's resource name. @@ -920,7 +920,7 @@ public function createApiSpec( } /** - * CreateApiVersion creates a specified version. + * Creates a specified version. * * Sample code: * ``` @@ -936,7 +936,7 @@ public function createApiSpec( * ``` * * @param string $parent Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @param ApiVersion $apiVersion Required. The version to create. * @param string $apiVersionId Required. The ID to use for the version, which will become the final component of * the version's resource name. @@ -985,7 +985,7 @@ public function createApiVersion( } /** - * CreateArtifact creates a specified artifact. + * Creates a specified artifact. * * Sample code: * ``` @@ -1001,7 +1001,7 @@ public function createApiVersion( * ``` * * @param string $parent Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * @param Artifact $artifact Required. The artifact to create. * @param string $artifactId Required. The ID to use for the artifact, which will become the final component of * the artifact's resource name. @@ -1050,7 +1050,7 @@ public function createArtifact( } /** - * DeleteApi removes a specified API and all of the resources that it + * Removes a specified API and all of the resources that it * owns. * * Sample code: @@ -1065,10 +1065,13 @@ public function createArtifact( * ``` * * @param string $name Required. The name of the API to delete. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @param array $optionalArgs { * Optional. * + * @type bool $force + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) * @type RetrySettings|array $retrySettings * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an * associative array of retry settings parameters. See the documentation on @@ -1083,6 +1086,10 @@ public function deleteApi($name, array $optionalArgs = []) $requestParamHeaders = []; $request->setName($name); $requestParamHeaders['name'] = $name; + if (isset($optionalArgs['force'])) { + $request->setForce($optionalArgs['force']); + } + $requestParams = new RequestParamsHeaderDescriptor( $requestParamHeaders ); @@ -1098,8 +1105,8 @@ public function deleteApi($name, array $optionalArgs = []) } /** - * DeleteApiDeployment removes a specified deployment, all revisions, and all - * child resources (e.g. artifacts). + * Removes a specified deployment, all revisions, and all + * child resources (e.g., artifacts). * * Sample code: * ``` @@ -1113,7 +1120,7 @@ public function deleteApi($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the deployment to delete. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * @param array $optionalArgs { * Optional. * @@ -1153,7 +1160,7 @@ public function deleteApiDeployment($name, array $optionalArgs = []) } /** - * DeleteApiDeploymentRevision deletes a revision of a deployment. + * Deletes a revision of a deployment. * * Sample code: * ``` @@ -1170,7 +1177,7 @@ public function deleteApiDeployment($name, array $optionalArgs = []) * with a revision ID explicitly included. * * Example: - * projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/deployments/prod@c7cfa2a8` * @param array $optionalArgs { * Optional. * @@ -1205,8 +1212,8 @@ public function deleteApiDeploymentRevision($name, array $optionalArgs = []) } /** - * DeleteApiSpec removes a specified spec, all revisions, and all child - * resources (e.g. artifacts). + * Removes a specified spec, all revisions, and all child + * resources (e.g., artifacts). * * Sample code: * ``` @@ -1220,7 +1227,7 @@ public function deleteApiDeploymentRevision($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the spec to delete. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * @param array $optionalArgs { * Optional. * @@ -1260,7 +1267,7 @@ public function deleteApiSpec($name, array $optionalArgs = []) } /** - * DeleteApiSpecRevision deletes a revision of a spec. + * Deletes a revision of a spec. * * Sample code: * ``` @@ -1277,7 +1284,7 @@ public function deleteApiSpec($name, array $optionalArgs = []) * with a revision ID explicitly included. * * Example: - * projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8 + * `projects/sample/locations/global/apis/petstore/versions/1.0.0/specs/openapi.yaml@c7cfa2a8` * @param array $optionalArgs { * Optional. * @@ -1312,7 +1319,7 @@ public function deleteApiSpecRevision($name, array $optionalArgs = []) } /** - * DeleteApiVersion removes a specified version and all of the resources that + * Removes a specified version and all of the resources that * it owns. * * Sample code: @@ -1327,10 +1334,13 @@ public function deleteApiSpecRevision($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the version to delete. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @param array $optionalArgs { * Optional. * + * @type bool $force + * If set to true, any child resources will also be deleted. + * (Otherwise, the request will only work if there are no child resources.) * @type RetrySettings|array $retrySettings * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an * associative array of retry settings parameters. See the documentation on @@ -1345,6 +1355,10 @@ public function deleteApiVersion($name, array $optionalArgs = []) $requestParamHeaders = []; $request->setName($name); $requestParamHeaders['name'] = $name; + if (isset($optionalArgs['force'])) { + $request->setForce($optionalArgs['force']); + } + $requestParams = new RequestParamsHeaderDescriptor( $requestParamHeaders ); @@ -1360,7 +1374,7 @@ public function deleteApiVersion($name, array $optionalArgs = []) } /** - * DeleteArtifact removes a specified artifact. + * Removes a specified artifact. * * Sample code: * ``` @@ -1374,7 +1388,7 @@ public function deleteApiVersion($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the artifact to delete. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * @param array $optionalArgs { * Optional. * @@ -1407,7 +1421,7 @@ public function deleteArtifact($name, array $optionalArgs = []) } /** - * GetApi returns a specified API. + * Returns a specified API. * * Sample code: * ``` @@ -1421,7 +1435,7 @@ public function deleteArtifact($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the API to retrieve. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @param array $optionalArgs { * Optional. * @@ -1456,7 +1470,7 @@ public function getApi($name, array $optionalArgs = []) } /** - * GetApiDeployment returns a specified deployment. + * Returns a specified deployment. * * Sample code: * ``` @@ -1470,7 +1484,7 @@ public function getApi($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the deployment to retrieve. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * @param array $optionalArgs { * Optional. * @@ -1505,7 +1519,7 @@ public function getApiDeployment($name, array $optionalArgs = []) } /** - * GetApiSpec returns a specified spec. + * Returns a specified spec. * * Sample code: * ``` @@ -1519,7 +1533,7 @@ public function getApiDeployment($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the spec to retrieve. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * @param array $optionalArgs { * Optional. * @@ -1554,7 +1568,7 @@ public function getApiSpec($name, array $optionalArgs = []) } /** - * GetApiSpecContents returns the contents of a specified spec. + * Returns the contents of a specified spec. * If specs are stored with GZip compression, the default behavior * is to return the spec uncompressed (the mime_type response field * indicates the exact format returned). @@ -1571,7 +1585,7 @@ public function getApiSpec($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the spec whose contents should be retrieved. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * @param array $optionalArgs { * Optional. * @@ -1606,7 +1620,7 @@ public function getApiSpecContents($name, array $optionalArgs = []) } /** - * GetApiVersion returns a specified version. + * Returns a specified version. * * Sample code: * ``` @@ -1620,7 +1634,7 @@ public function getApiSpecContents($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the version to retrieve. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @param array $optionalArgs { * Optional. * @@ -1655,7 +1669,7 @@ public function getApiVersion($name, array $optionalArgs = []) } /** - * GetArtifact returns a specified artifact. + * Returns a specified artifact. * * Sample code: * ``` @@ -1669,7 +1683,7 @@ public function getApiVersion($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the artifact to retrieve. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * @param array $optionalArgs { * Optional. * @@ -1704,7 +1718,7 @@ public function getArtifact($name, array $optionalArgs = []) } /** - * GetArtifactContents returns the contents of a specified artifact. + * Returns the contents of a specified artifact. * If artifacts are stored with GZip compression, the default behavior * is to return the artifact uncompressed (the mime_type response field * indicates the exact format returned). @@ -1721,7 +1735,7 @@ public function getArtifact($name, array $optionalArgs = []) * ``` * * @param string $name Required. The name of the artifact whose contents should be retrieved. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * @param array $optionalArgs { * Optional. * @@ -1756,7 +1770,7 @@ public function getArtifactContents($name, array $optionalArgs = []) } /** - * ListApiDeploymentRevisions lists all revisions of a deployment. + * Lists all revisions of a deployment. * Revisions are returned in descending order of revision creation time. * * Sample code: @@ -1834,7 +1848,7 @@ public function listApiDeploymentRevisions($name, array $optionalArgs = []) } /** - * ListApiDeployments returns matching deployments. + * Returns matching deployments. * * Sample code: * ``` @@ -1860,7 +1874,7 @@ public function listApiDeploymentRevisions($name, array $optionalArgs = []) * ``` * * @param string $parent Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @param array $optionalArgs { * Optional. * @@ -1919,7 +1933,7 @@ public function listApiDeployments($parent, array $optionalArgs = []) } /** - * ListApiSpecRevisions lists all revisions of a spec. + * Lists all revisions of a spec. * Revisions are returned in descending order of revision creation time. * * Sample code: @@ -1997,7 +2011,7 @@ public function listApiSpecRevisions($name, array $optionalArgs = []) } /** - * ListApiSpecs returns matching specs. + * Returns matching specs. * * Sample code: * ``` @@ -2023,7 +2037,7 @@ public function listApiSpecRevisions($name, array $optionalArgs = []) * ``` * * @param string $parent Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @param array $optionalArgs { * Optional. * @@ -2082,7 +2096,7 @@ public function listApiSpecs($parent, array $optionalArgs = []) } /** - * ListApiVersions returns matching versions. + * Returns matching versions. * * Sample code: * ``` @@ -2108,7 +2122,7 @@ public function listApiSpecs($parent, array $optionalArgs = []) * ``` * * @param string $parent Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @param array $optionalArgs { * Optional. * @@ -2167,7 +2181,7 @@ public function listApiVersions($parent, array $optionalArgs = []) } /** - * ListApis returns matching APIs. + * Returns matching APIs. * * Sample code: * ``` @@ -2193,7 +2207,7 @@ public function listApiVersions($parent, array $optionalArgs = []) * ``` * * @param string $parent Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * @param array $optionalArgs { * Optional. * @@ -2252,7 +2266,7 @@ public function listApis($parent, array $optionalArgs = []) } /** - * ListArtifacts returns matching artifacts. + * Returns matching artifacts. * * Sample code: * ``` @@ -2278,7 +2292,7 @@ public function listApis($parent, array $optionalArgs = []) * ``` * * @param string $parent Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * @param array $optionalArgs { * Optional. * @@ -2337,7 +2351,7 @@ public function listArtifacts($parent, array $optionalArgs = []) } /** - * ReplaceArtifact can be used to replace a specified artifact. + * Used to replace a specified artifact. * * Sample code: * ``` @@ -2353,7 +2367,7 @@ public function listArtifacts($parent, array $optionalArgs = []) * @param Artifact $artifact Required. The artifact to replace. * * The `name` field is used to identify the artifact to replace. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * @param array $optionalArgs { * Optional. * @@ -2388,7 +2402,7 @@ public function replaceArtifact($artifact, array $optionalArgs = []) } /** - * RollbackApiDeployment sets the current revision to a specified prior + * Sets the current revision to a specified prior * revision. Note that this creates a new revision with a new revision ID. * * Sample code: @@ -2407,7 +2421,7 @@ public function replaceArtifact($artifact, array $optionalArgs = []) * @param string $revisionId Required. The revision ID to roll back to. * It must be a revision of the same deployment. * - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * @param array $optionalArgs { * Optional. * @@ -2446,7 +2460,7 @@ public function rollbackApiDeployment( } /** - * RollbackApiSpec sets the current revision to a specified prior revision. + * Sets the current revision to a specified prior revision. * Note that this creates a new revision with a new revision ID. * * Sample code: @@ -2465,7 +2479,7 @@ public function rollbackApiDeployment( * @param string $revisionId Required. The revision ID to roll back to. * It must be a revision of the same spec. * - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * @param array $optionalArgs { * Optional. * @@ -2504,7 +2518,7 @@ public function rollbackApiSpec( } /** - * TagApiDeploymentRevision adds a tag to a specified revision of a + * Adds a tag to a specified revision of a * deployment. * * Sample code: @@ -2560,7 +2574,7 @@ public function tagApiDeploymentRevision( } /** - * TagApiSpecRevision adds a tag to a specified revision of a spec. + * Adds a tag to a specified revision of a spec. * * Sample code: * ``` @@ -2612,7 +2626,7 @@ public function tagApiSpecRevision($name, $tag, array $optionalArgs = []) } /** - * UpdateApi can be used to modify a specified API. + * Used to modify a specified API. * * Sample code: * ``` @@ -2628,17 +2642,17 @@ public function tagApiSpecRevision($name, $tag, array $optionalArgs = []) * @param Api $api Required. The API to update. * * The `name` field is used to identify the API to update. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @param array $optionalArgs { * Optional. * * @type FieldMask $updateMask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allowMissing - * If set to true, and the api is not found, a new api will be created. + * If set to true, and the API is not found, a new API will be created. * In this situation, `update_mask` is ignored. * @type RetrySettings|array $retrySettings * Retry settings to use for this call. Can be a {@see RetrySettings} object, or an @@ -2679,7 +2693,7 @@ public function updateApi($api, array $optionalArgs = []) } /** - * UpdateApiDeployment can be used to modify a specified deployment. + * Used to modify a specified deployment. * * Sample code: * ``` @@ -2695,15 +2709,15 @@ public function updateApi($api, array $optionalArgs = []) * @param ApiDeployment $apiDeployment Required. The deployment to update. * * The `name` field is used to identify the deployment to update. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * @param array $optionalArgs { * Optional. * * @type FieldMask $updateMask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allowMissing * If set to true, and the deployment is not found, a new deployment will be * created. In this situation, `update_mask` is ignored. @@ -2748,7 +2762,7 @@ public function updateApiDeployment( } /** - * UpdateApiSpec can be used to modify a specified spec. + * Used to modify a specified spec. * * Sample code: * ``` @@ -2764,15 +2778,15 @@ public function updateApiDeployment( * @param ApiSpec $apiSpec Required. The spec to update. * * The `name` field is used to identify the spec to update. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * @param array $optionalArgs { * Optional. * * @type FieldMask $updateMask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allowMissing * If set to true, and the spec is not found, a new spec will be created. * In this situation, `update_mask` is ignored. @@ -2815,7 +2829,7 @@ public function updateApiSpec($apiSpec, array $optionalArgs = []) } /** - * UpdateApiVersion can be used to modify a specified version. + * Used to modify a specified version. * * Sample code: * ``` @@ -2831,15 +2845,15 @@ public function updateApiSpec($apiSpec, array $optionalArgs = []) * @param ApiVersion $apiVersion Required. The version to update. * * The `name` field is used to identify the version to update. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @param array $optionalArgs { * Optional. * * @type FieldMask $updateMask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allowMissing * If set to true, and the version is not found, a new version will be * created. In this situation, `update_mask` is ignored. diff --git a/ApigeeRegistry/src/V1/GetApiDeploymentRequest.php b/ApigeeRegistry/src/V1/GetApiDeploymentRequest.php index 02d95e09094e..a58117005ea7 100644 --- a/ApigeeRegistry/src/V1/GetApiDeploymentRequest.php +++ b/ApigeeRegistry/src/V1/GetApiDeploymentRequest.php @@ -17,7 +17,7 @@ class GetApiDeploymentRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the deployment to retrieve. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class GetApiDeploymentRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the deployment to retrieve. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the deployment to retrieve. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the deployment to retrieve. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/GetApiRequest.php b/ApigeeRegistry/src/V1/GetApiRequest.php index 2cc2a044e56d..54c8ac14a988 100644 --- a/ApigeeRegistry/src/V1/GetApiRequest.php +++ b/ApigeeRegistry/src/V1/GetApiRequest.php @@ -17,7 +17,7 @@ class GetApiRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the API to retrieve. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class GetApiRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the API to retrieve. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the API to retrieve. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the API to retrieve. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/GetApiSpecContentsRequest.php b/ApigeeRegistry/src/V1/GetApiSpecContentsRequest.php index 2388ab8b1466..c9f9c03e9a60 100644 --- a/ApigeeRegistry/src/V1/GetApiSpecContentsRequest.php +++ b/ApigeeRegistry/src/V1/GetApiSpecContentsRequest.php @@ -17,7 +17,7 @@ class GetApiSpecContentsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the spec whose contents should be retrieved. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class GetApiSpecContentsRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the spec whose contents should be retrieved. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the spec whose contents should be retrieved. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the spec whose contents should be retrieved. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/GetApiSpecRequest.php b/ApigeeRegistry/src/V1/GetApiSpecRequest.php index 0f47f770fbe1..b1b9f9eec4c2 100644 --- a/ApigeeRegistry/src/V1/GetApiSpecRequest.php +++ b/ApigeeRegistry/src/V1/GetApiSpecRequest.php @@ -17,7 +17,7 @@ class GetApiSpecRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the spec to retrieve. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class GetApiSpecRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the spec to retrieve. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the spec to retrieve. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the spec to retrieve. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/GetApiVersionRequest.php b/ApigeeRegistry/src/V1/GetApiVersionRequest.php index 794715826773..d7debc11b908 100644 --- a/ApigeeRegistry/src/V1/GetApiVersionRequest.php +++ b/ApigeeRegistry/src/V1/GetApiVersionRequest.php @@ -17,7 +17,7 @@ class GetApiVersionRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the version to retrieve. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class GetApiVersionRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the version to retrieve. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the version to retrieve. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the version to retrieve. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/GetArtifactContentsRequest.php b/ApigeeRegistry/src/V1/GetArtifactContentsRequest.php index 7b507e48a07e..b81e4e69b6f3 100644 --- a/ApigeeRegistry/src/V1/GetArtifactContentsRequest.php +++ b/ApigeeRegistry/src/V1/GetArtifactContentsRequest.php @@ -17,7 +17,7 @@ class GetArtifactContentsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the artifact whose contents should be retrieved. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class GetArtifactContentsRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the artifact whose contents should be retrieved. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the artifact whose contents should be retrieved. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the artifact whose contents should be retrieved. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/GetArtifactRequest.php b/ApigeeRegistry/src/V1/GetArtifactRequest.php index 1e9a611ecab1..be9ee8e46d03 100644 --- a/ApigeeRegistry/src/V1/GetArtifactRequest.php +++ b/ApigeeRegistry/src/V1/GetArtifactRequest.php @@ -17,7 +17,7 @@ class GetArtifactRequest extends \Google\Protobuf\Internal\Message { /** * Required. The name of the artifact to retrieve. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -31,7 +31,7 @@ class GetArtifactRequest extends \Google\Protobuf\Internal\Message * * @type string $name * Required. The name of the artifact to retrieve. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * } */ public function __construct($data = NULL) { @@ -41,7 +41,7 @@ public function __construct($data = NULL) { /** * Required. The name of the artifact to retrieve. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -53,7 +53,7 @@ public function getName() /** * Required. The name of the artifact to retrieve. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field string name = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/Instance.php b/ApigeeRegistry/src/V1/Instance.php index 8cb02148ffd5..54b2b2afaa23 100644 --- a/ApigeeRegistry/src/V1/Instance.php +++ b/ApigeeRegistry/src/V1/Instance.php @@ -18,7 +18,7 @@ class Instance extends \Google\Protobuf\Internal\Message { /** * Format: `projects/*/locations/*/instance`. - * Currently only locations/global is supported. + * Currently only `locations/global` is supported. * * Generated from protobuf field string name = 1; */ @@ -62,7 +62,7 @@ class Instance extends \Google\Protobuf\Internal\Message * * @type string $name * Format: `projects/*/locations/*/instance`. - * Currently only locations/global is supported. + * Currently only `locations/global` is supported. * @type \Google\Protobuf\Timestamp $create_time * Output only. Creation timestamp. * @type \Google\Protobuf\Timestamp $update_time @@ -82,7 +82,7 @@ public function __construct($data = NULL) { /** * Format: `projects/*/locations/*/instance`. - * Currently only locations/global is supported. + * Currently only `locations/global` is supported. * * Generated from protobuf field string name = 1; * @return string @@ -94,7 +94,7 @@ public function getName() /** * Format: `projects/*/locations/*/instance`. - * Currently only locations/global is supported. + * Currently only `locations/global` is supported. * * Generated from protobuf field string name = 1; * @param string $var diff --git a/ApigeeRegistry/src/V1/ListApiDeploymentsRequest.php b/ApigeeRegistry/src/V1/ListApiDeploymentsRequest.php index 7528e8d0f4c9..2cf875a3e099 100644 --- a/ApigeeRegistry/src/V1/ListApiDeploymentsRequest.php +++ b/ApigeeRegistry/src/V1/ListApiDeploymentsRequest.php @@ -17,7 +17,7 @@ class ListApiDeploymentsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -56,7 +56,7 @@ class ListApiDeploymentsRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @type int $page_size * The maximum number of deployments to return. * The service may return fewer than this value. @@ -79,7 +79,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -91,7 +91,7 @@ public function getParent() /** * Required. The parent, which owns this collection of deployments. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/ListApiSpecsRequest.php b/ApigeeRegistry/src/V1/ListApiSpecsRequest.php index 58926f0512d0..f491680b3301 100644 --- a/ApigeeRegistry/src/V1/ListApiSpecsRequest.php +++ b/ApigeeRegistry/src/V1/ListApiSpecsRequest.php @@ -17,7 +17,7 @@ class ListApiSpecsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -56,7 +56,7 @@ class ListApiSpecsRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @type int $page_size * The maximum number of specs to return. * The service may return fewer than this value. @@ -79,7 +79,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -91,7 +91,7 @@ public function getParent() /** * Required. The parent, which owns this collection of specs. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/ListApiVersionsRequest.php b/ApigeeRegistry/src/V1/ListApiVersionsRequest.php index d59a5888df53..89d073da0ae7 100644 --- a/ApigeeRegistry/src/V1/ListApiVersionsRequest.php +++ b/ApigeeRegistry/src/V1/ListApiVersionsRequest.php @@ -17,7 +17,7 @@ class ListApiVersionsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -56,7 +56,7 @@ class ListApiVersionsRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @type int $page_size * The maximum number of versions to return. * The service may return fewer than this value. @@ -79,7 +79,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -91,7 +91,7 @@ public function getParent() /** * Required. The parent, which owns this collection of versions. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/ListApisRequest.php b/ApigeeRegistry/src/V1/ListApisRequest.php index ff0f33249a07..0114dfb2b39b 100644 --- a/ApigeeRegistry/src/V1/ListApisRequest.php +++ b/ApigeeRegistry/src/V1/ListApisRequest.php @@ -17,7 +17,7 @@ class ListApisRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -56,7 +56,7 @@ class ListApisRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * @type int $page_size * The maximum number of APIs to return. * The service may return fewer than this value. @@ -79,7 +79,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -91,7 +91,7 @@ public function getParent() /** * Required. The parent, which owns this collection of APIs. - * Format: projects/*/locations/* + * Format: `projects/*/locations/*` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/ListArtifactsRequest.php b/ApigeeRegistry/src/V1/ListArtifactsRequest.php index 9c1af8189d94..a2ec41114dd4 100644 --- a/ApigeeRegistry/src/V1/ListArtifactsRequest.php +++ b/ApigeeRegistry/src/V1/ListArtifactsRequest.php @@ -17,7 +17,7 @@ class ListArtifactsRequest extends \Google\Protobuf\Internal\Message { /** * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { */ @@ -56,7 +56,7 @@ class ListArtifactsRequest extends \Google\Protobuf\Internal\Message * * @type string $parent * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * @type int $page_size * The maximum number of artifacts to return. * The service may return fewer than this value. @@ -79,7 +79,7 @@ public function __construct($data = NULL) { /** * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @return string @@ -91,7 +91,7 @@ public function getParent() /** * Required. The parent, which owns this collection of artifacts. - * Format: {parent} + * Format: `{parent}` * * Generated from protobuf field string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { * @param string $var diff --git a/ApigeeRegistry/src/V1/RegistryGrpcClient.php b/ApigeeRegistry/src/V1/RegistryGrpcClient.php index 676b4d7fb049..3d9bc9f16308 100644 --- a/ApigeeRegistry/src/V1/RegistryGrpcClient.php +++ b/ApigeeRegistry/src/V1/RegistryGrpcClient.php @@ -33,7 +33,7 @@ public function __construct($hostname, $opts, $channel = null) { } /** - * ListApis returns matching APIs. + * Returns matching APIs. * @param \Google\Cloud\ApigeeRegistry\V1\ListApisRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -48,7 +48,7 @@ public function ListApis(\Google\Cloud\ApigeeRegistry\V1\ListApisRequest $argume } /** - * GetApi returns a specified API. + * Returns a specified API. * @param \Google\Cloud\ApigeeRegistry\V1\GetApiRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -63,7 +63,7 @@ public function GetApi(\Google\Cloud\ApigeeRegistry\V1\GetApiRequest $argument, } /** - * CreateApi creates a specified API. + * Creates a specified API. * @param \Google\Cloud\ApigeeRegistry\V1\CreateApiRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -78,7 +78,7 @@ public function CreateApi(\Google\Cloud\ApigeeRegistry\V1\CreateApiRequest $argu } /** - * UpdateApi can be used to modify a specified API. + * Used to modify a specified API. * @param \Google\Cloud\ApigeeRegistry\V1\UpdateApiRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -93,7 +93,7 @@ public function UpdateApi(\Google\Cloud\ApigeeRegistry\V1\UpdateApiRequest $argu } /** - * DeleteApi removes a specified API and all of the resources that it + * Removes a specified API and all of the resources that it * owns. * @param \Google\Cloud\ApigeeRegistry\V1\DeleteApiRequest $argument input argument * @param array $metadata metadata @@ -109,7 +109,7 @@ public function DeleteApi(\Google\Cloud\ApigeeRegistry\V1\DeleteApiRequest $argu } /** - * ListApiVersions returns matching versions. + * Returns matching versions. * @param \Google\Cloud\ApigeeRegistry\V1\ListApiVersionsRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -124,7 +124,7 @@ public function ListApiVersions(\Google\Cloud\ApigeeRegistry\V1\ListApiVersionsR } /** - * GetApiVersion returns a specified version. + * Returns a specified version. * @param \Google\Cloud\ApigeeRegistry\V1\GetApiVersionRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -139,7 +139,7 @@ public function GetApiVersion(\Google\Cloud\ApigeeRegistry\V1\GetApiVersionReque } /** - * CreateApiVersion creates a specified version. + * Creates a specified version. * @param \Google\Cloud\ApigeeRegistry\V1\CreateApiVersionRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -154,7 +154,7 @@ public function CreateApiVersion(\Google\Cloud\ApigeeRegistry\V1\CreateApiVersio } /** - * UpdateApiVersion can be used to modify a specified version. + * Used to modify a specified version. * @param \Google\Cloud\ApigeeRegistry\V1\UpdateApiVersionRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -169,7 +169,7 @@ public function UpdateApiVersion(\Google\Cloud\ApigeeRegistry\V1\UpdateApiVersio } /** - * DeleteApiVersion removes a specified version and all of the resources that + * Removes a specified version and all of the resources that * it owns. * @param \Google\Cloud\ApigeeRegistry\V1\DeleteApiVersionRequest $argument input argument * @param array $metadata metadata @@ -185,7 +185,7 @@ public function DeleteApiVersion(\Google\Cloud\ApigeeRegistry\V1\DeleteApiVersio } /** - * ListApiSpecs returns matching specs. + * Returns matching specs. * @param \Google\Cloud\ApigeeRegistry\V1\ListApiSpecsRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -200,7 +200,7 @@ public function ListApiSpecs(\Google\Cloud\ApigeeRegistry\V1\ListApiSpecsRequest } /** - * GetApiSpec returns a specified spec. + * Returns a specified spec. * @param \Google\Cloud\ApigeeRegistry\V1\GetApiSpecRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -215,7 +215,7 @@ public function GetApiSpec(\Google\Cloud\ApigeeRegistry\V1\GetApiSpecRequest $ar } /** - * GetApiSpecContents returns the contents of a specified spec. + * Returns the contents of a specified spec. * If specs are stored with GZip compression, the default behavior * is to return the spec uncompressed (the mime_type response field * indicates the exact format returned). @@ -233,7 +233,7 @@ public function GetApiSpecContents(\Google\Cloud\ApigeeRegistry\V1\GetApiSpecCon } /** - * CreateApiSpec creates a specified spec. + * Creates a specified spec. * @param \Google\Cloud\ApigeeRegistry\V1\CreateApiSpecRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -248,7 +248,7 @@ public function CreateApiSpec(\Google\Cloud\ApigeeRegistry\V1\CreateApiSpecReque } /** - * UpdateApiSpec can be used to modify a specified spec. + * Used to modify a specified spec. * @param \Google\Cloud\ApigeeRegistry\V1\UpdateApiSpecRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -263,8 +263,8 @@ public function UpdateApiSpec(\Google\Cloud\ApigeeRegistry\V1\UpdateApiSpecReque } /** - * DeleteApiSpec removes a specified spec, all revisions, and all child - * resources (e.g. artifacts). + * Removes a specified spec, all revisions, and all child + * resources (e.g., artifacts). * @param \Google\Cloud\ApigeeRegistry\V1\DeleteApiSpecRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -279,7 +279,7 @@ public function DeleteApiSpec(\Google\Cloud\ApigeeRegistry\V1\DeleteApiSpecReque } /** - * TagApiSpecRevision adds a tag to a specified revision of a spec. + * Adds a tag to a specified revision of a spec. * @param \Google\Cloud\ApigeeRegistry\V1\TagApiSpecRevisionRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -294,7 +294,7 @@ public function TagApiSpecRevision(\Google\Cloud\ApigeeRegistry\V1\TagApiSpecRev } /** - * ListApiSpecRevisions lists all revisions of a spec. + * Lists all revisions of a spec. * Revisions are returned in descending order of revision creation time. * @param \Google\Cloud\ApigeeRegistry\V1\ListApiSpecRevisionsRequest $argument input argument * @param array $metadata metadata @@ -310,7 +310,7 @@ public function ListApiSpecRevisions(\Google\Cloud\ApigeeRegistry\V1\ListApiSpec } /** - * RollbackApiSpec sets the current revision to a specified prior revision. + * Sets the current revision to a specified prior revision. * Note that this creates a new revision with a new revision ID. * @param \Google\Cloud\ApigeeRegistry\V1\RollbackApiSpecRequest $argument input argument * @param array $metadata metadata @@ -326,7 +326,7 @@ public function RollbackApiSpec(\Google\Cloud\ApigeeRegistry\V1\RollbackApiSpecR } /** - * DeleteApiSpecRevision deletes a revision of a spec. + * Deletes a revision of a spec. * @param \Google\Cloud\ApigeeRegistry\V1\DeleteApiSpecRevisionRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -341,7 +341,7 @@ public function DeleteApiSpecRevision(\Google\Cloud\ApigeeRegistry\V1\DeleteApiS } /** - * ListApiDeployments returns matching deployments. + * Returns matching deployments. * @param \Google\Cloud\ApigeeRegistry\V1\ListApiDeploymentsRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -356,7 +356,7 @@ public function ListApiDeployments(\Google\Cloud\ApigeeRegistry\V1\ListApiDeploy } /** - * GetApiDeployment returns a specified deployment. + * Returns a specified deployment. * @param \Google\Cloud\ApigeeRegistry\V1\GetApiDeploymentRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -371,7 +371,7 @@ public function GetApiDeployment(\Google\Cloud\ApigeeRegistry\V1\GetApiDeploymen } /** - * CreateApiDeployment creates a specified deployment. + * Creates a specified deployment. * @param \Google\Cloud\ApigeeRegistry\V1\CreateApiDeploymentRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -386,7 +386,7 @@ public function CreateApiDeployment(\Google\Cloud\ApigeeRegistry\V1\CreateApiDep } /** - * UpdateApiDeployment can be used to modify a specified deployment. + * Used to modify a specified deployment. * @param \Google\Cloud\ApigeeRegistry\V1\UpdateApiDeploymentRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -401,8 +401,8 @@ public function UpdateApiDeployment(\Google\Cloud\ApigeeRegistry\V1\UpdateApiDep } /** - * DeleteApiDeployment removes a specified deployment, all revisions, and all - * child resources (e.g. artifacts). + * Removes a specified deployment, all revisions, and all + * child resources (e.g., artifacts). * @param \Google\Cloud\ApigeeRegistry\V1\DeleteApiDeploymentRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -417,7 +417,7 @@ public function DeleteApiDeployment(\Google\Cloud\ApigeeRegistry\V1\DeleteApiDep } /** - * TagApiDeploymentRevision adds a tag to a specified revision of a + * Adds a tag to a specified revision of a * deployment. * @param \Google\Cloud\ApigeeRegistry\V1\TagApiDeploymentRevisionRequest $argument input argument * @param array $metadata metadata @@ -433,7 +433,7 @@ public function TagApiDeploymentRevision(\Google\Cloud\ApigeeRegistry\V1\TagApiD } /** - * ListApiDeploymentRevisions lists all revisions of a deployment. + * Lists all revisions of a deployment. * Revisions are returned in descending order of revision creation time. * @param \Google\Cloud\ApigeeRegistry\V1\ListApiDeploymentRevisionsRequest $argument input argument * @param array $metadata metadata @@ -449,7 +449,7 @@ public function ListApiDeploymentRevisions(\Google\Cloud\ApigeeRegistry\V1\ListA } /** - * RollbackApiDeployment sets the current revision to a specified prior + * Sets the current revision to a specified prior * revision. Note that this creates a new revision with a new revision ID. * @param \Google\Cloud\ApigeeRegistry\V1\RollbackApiDeploymentRequest $argument input argument * @param array $metadata metadata @@ -465,7 +465,7 @@ public function RollbackApiDeployment(\Google\Cloud\ApigeeRegistry\V1\RollbackAp } /** - * DeleteApiDeploymentRevision deletes a revision of a deployment. + * Deletes a revision of a deployment. * @param \Google\Cloud\ApigeeRegistry\V1\DeleteApiDeploymentRevisionRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -480,7 +480,7 @@ public function DeleteApiDeploymentRevision(\Google\Cloud\ApigeeRegistry\V1\Dele } /** - * ListArtifacts returns matching artifacts. + * Returns matching artifacts. * @param \Google\Cloud\ApigeeRegistry\V1\ListArtifactsRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -495,7 +495,7 @@ public function ListArtifacts(\Google\Cloud\ApigeeRegistry\V1\ListArtifactsReque } /** - * GetArtifact returns a specified artifact. + * Returns a specified artifact. * @param \Google\Cloud\ApigeeRegistry\V1\GetArtifactRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -510,7 +510,7 @@ public function GetArtifact(\Google\Cloud\ApigeeRegistry\V1\GetArtifactRequest $ } /** - * GetArtifactContents returns the contents of a specified artifact. + * Returns the contents of a specified artifact. * If artifacts are stored with GZip compression, the default behavior * is to return the artifact uncompressed (the mime_type response field * indicates the exact format returned). @@ -528,7 +528,7 @@ public function GetArtifactContents(\Google\Cloud\ApigeeRegistry\V1\GetArtifactC } /** - * CreateArtifact creates a specified artifact. + * Creates a specified artifact. * @param \Google\Cloud\ApigeeRegistry\V1\CreateArtifactRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -543,7 +543,7 @@ public function CreateArtifact(\Google\Cloud\ApigeeRegistry\V1\CreateArtifactReq } /** - * ReplaceArtifact can be used to replace a specified artifact. + * Used to replace a specified artifact. * @param \Google\Cloud\ApigeeRegistry\V1\ReplaceArtifactRequest $argument input argument * @param array $metadata metadata * @param array $options call options @@ -558,7 +558,7 @@ public function ReplaceArtifact(\Google\Cloud\ApigeeRegistry\V1\ReplaceArtifactR } /** - * DeleteArtifact removes a specified artifact. + * Removes a specified artifact. * @param \Google\Cloud\ApigeeRegistry\V1\DeleteArtifactRequest $argument input argument * @param array $metadata metadata * @param array $options call options diff --git a/ApigeeRegistry/src/V1/ReplaceArtifactRequest.php b/ApigeeRegistry/src/V1/ReplaceArtifactRequest.php index 7bedcc2d6173..252e155b2a66 100644 --- a/ApigeeRegistry/src/V1/ReplaceArtifactRequest.php +++ b/ApigeeRegistry/src/V1/ReplaceArtifactRequest.php @@ -18,7 +18,7 @@ class ReplaceArtifactRequest extends \Google\Protobuf\Internal\Message /** * Required. The artifact to replace. * The `name` field is used to identify the artifact to replace. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.Artifact artifact = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -33,7 +33,7 @@ class ReplaceArtifactRequest extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\ApigeeRegistry\V1\Artifact $artifact * Required. The artifact to replace. * The `name` field is used to identify the artifact to replace. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * } */ public function __construct($data = NULL) { @@ -44,7 +44,7 @@ public function __construct($data = NULL) { /** * Required. The artifact to replace. * The `name` field is used to identify the artifact to replace. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.Artifact artifact = 1 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\ApigeeRegistry\V1\Artifact|null @@ -67,7 +67,7 @@ public function clearArtifact() /** * Required. The artifact to replace. * The `name` field is used to identify the artifact to replace. - * Format: {parent}/artifacts/* + * Format: `{parent}/artifacts/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.Artifact artifact = 1 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\ApigeeRegistry\V1\Artifact $var diff --git a/ApigeeRegistry/src/V1/RollbackApiDeploymentRequest.php b/ApigeeRegistry/src/V1/RollbackApiDeploymentRequest.php index 989e3800998f..4aa046ed9e13 100644 --- a/ApigeeRegistry/src/V1/RollbackApiDeploymentRequest.php +++ b/ApigeeRegistry/src/V1/RollbackApiDeploymentRequest.php @@ -24,7 +24,7 @@ class RollbackApiDeploymentRequest extends \Google\Protobuf\Internal\Message /** * Required. The revision ID to roll back to. * It must be a revision of the same deployment. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * * Generated from protobuf field string revision_id = 2 [(.google.api.field_behavior) = REQUIRED]; */ @@ -41,7 +41,7 @@ class RollbackApiDeploymentRequest extends \Google\Protobuf\Internal\Message * @type string $revision_id * Required. The revision ID to roll back to. * It must be a revision of the same deployment. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * } */ public function __construct($data = NULL) { @@ -78,7 +78,7 @@ public function setName($var) /** * Required. The revision ID to roll back to. * It must be a revision of the same deployment. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * * Generated from protobuf field string revision_id = 2 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -91,7 +91,7 @@ public function getRevisionId() /** * Required. The revision ID to roll back to. * It must be a revision of the same deployment. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * * Generated from protobuf field string revision_id = 2 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/ApigeeRegistry/src/V1/RollbackApiSpecRequest.php b/ApigeeRegistry/src/V1/RollbackApiSpecRequest.php index b28e4e36c108..36b90989a519 100644 --- a/ApigeeRegistry/src/V1/RollbackApiSpecRequest.php +++ b/ApigeeRegistry/src/V1/RollbackApiSpecRequest.php @@ -24,7 +24,7 @@ class RollbackApiSpecRequest extends \Google\Protobuf\Internal\Message /** * Required. The revision ID to roll back to. * It must be a revision of the same spec. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * * Generated from protobuf field string revision_id = 2 [(.google.api.field_behavior) = REQUIRED]; */ @@ -41,7 +41,7 @@ class RollbackApiSpecRequest extends \Google\Protobuf\Internal\Message * @type string $revision_id * Required. The revision ID to roll back to. * It must be a revision of the same spec. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * } */ public function __construct($data = NULL) { @@ -78,7 +78,7 @@ public function setName($var) /** * Required. The revision ID to roll back to. * It must be a revision of the same spec. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * * Generated from protobuf field string revision_id = 2 [(.google.api.field_behavior) = REQUIRED]; * @return string @@ -91,7 +91,7 @@ public function getRevisionId() /** * Required. The revision ID to roll back to. * It must be a revision of the same spec. - * Example: c7cfa2a8 + * Example: `c7cfa2a8` * * Generated from protobuf field string revision_id = 2 [(.google.api.field_behavior) = REQUIRED]; * @param string $var diff --git a/ApigeeRegistry/src/V1/UpdateApiDeploymentRequest.php b/ApigeeRegistry/src/V1/UpdateApiDeploymentRequest.php index 77043954cfaa..1c90348fd500 100644 --- a/ApigeeRegistry/src/V1/UpdateApiDeploymentRequest.php +++ b/ApigeeRegistry/src/V1/UpdateApiDeploymentRequest.php @@ -18,7 +18,7 @@ class UpdateApiDeploymentRequest extends \Google\Protobuf\Internal\Message /** * Required. The deployment to update. * The `name` field is used to identify the deployment to update. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiDeployment api_deployment = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -26,8 +26,8 @@ class UpdateApiDeploymentRequest extends \Google\Protobuf\Internal\Message /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; */ @@ -49,12 +49,12 @@ class UpdateApiDeploymentRequest extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\ApigeeRegistry\V1\ApiDeployment $api_deployment * Required. The deployment to update. * The `name` field is used to identify the deployment to update. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * @type \Google\Protobuf\FieldMask $update_mask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allow_missing * If set to true, and the deployment is not found, a new deployment will be * created. In this situation, `update_mask` is ignored. @@ -68,7 +68,7 @@ public function __construct($data = NULL) { /** * Required. The deployment to update. * The `name` field is used to identify the deployment to update. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiDeployment api_deployment = 1 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\ApigeeRegistry\V1\ApiDeployment|null @@ -91,7 +91,7 @@ public function clearApiDeployment() /** * Required. The deployment to update. * The `name` field is used to identify the deployment to update. - * Format: projects/*/locations/*/apis/*/deployments/* + * Format: `projects/*/locations/*/apis/*/deployments/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiDeployment api_deployment = 1 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\ApigeeRegistry\V1\ApiDeployment $var @@ -108,8 +108,8 @@ public function setApiDeployment($var) /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @return \Google\Protobuf\FieldMask|null @@ -132,8 +132,8 @@ public function clearUpdateMask() /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @param \Google\Protobuf\FieldMask $var diff --git a/ApigeeRegistry/src/V1/UpdateApiRequest.php b/ApigeeRegistry/src/V1/UpdateApiRequest.php index 38dfb3f811f7..ecadbe94ccd6 100644 --- a/ApigeeRegistry/src/V1/UpdateApiRequest.php +++ b/ApigeeRegistry/src/V1/UpdateApiRequest.php @@ -18,7 +18,7 @@ class UpdateApiRequest extends \Google\Protobuf\Internal\Message /** * Required. The API to update. * The `name` field is used to identify the API to update. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.Api api = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -26,14 +26,14 @@ class UpdateApiRequest extends \Google\Protobuf\Internal\Message /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; */ private $update_mask = null; /** - * If set to true, and the api is not found, a new api will be created. + * If set to true, and the API is not found, a new API will be created. * In this situation, `update_mask` is ignored. * * Generated from protobuf field bool allow_missing = 3; @@ -49,14 +49,14 @@ class UpdateApiRequest extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\ApigeeRegistry\V1\Api $api * Required. The API to update. * The `name` field is used to identify the API to update. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * @type \Google\Protobuf\FieldMask $update_mask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allow_missing - * If set to true, and the api is not found, a new api will be created. + * If set to true, and the API is not found, a new API will be created. * In this situation, `update_mask` is ignored. * } */ @@ -68,7 +68,7 @@ public function __construct($data = NULL) { /** * Required. The API to update. * The `name` field is used to identify the API to update. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.Api api = 1 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\ApigeeRegistry\V1\Api|null @@ -91,7 +91,7 @@ public function clearApi() /** * Required. The API to update. * The `name` field is used to identify the API to update. - * Format: projects/*/locations/*/apis/* + * Format: `projects/*/locations/*/apis/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.Api api = 1 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\ApigeeRegistry\V1\Api $var @@ -108,8 +108,8 @@ public function setApi($var) /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @return \Google\Protobuf\FieldMask|null @@ -132,8 +132,8 @@ public function clearUpdateMask() /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @param \Google\Protobuf\FieldMask $var @@ -148,7 +148,7 @@ public function setUpdateMask($var) } /** - * If set to true, and the api is not found, a new api will be created. + * If set to true, and the API is not found, a new API will be created. * In this situation, `update_mask` is ignored. * * Generated from protobuf field bool allow_missing = 3; @@ -160,7 +160,7 @@ public function getAllowMissing() } /** - * If set to true, and the api is not found, a new api will be created. + * If set to true, and the API is not found, a new API will be created. * In this situation, `update_mask` is ignored. * * Generated from protobuf field bool allow_missing = 3; diff --git a/ApigeeRegistry/src/V1/UpdateApiSpecRequest.php b/ApigeeRegistry/src/V1/UpdateApiSpecRequest.php index 263e5bc7516b..2f6a8061bd76 100644 --- a/ApigeeRegistry/src/V1/UpdateApiSpecRequest.php +++ b/ApigeeRegistry/src/V1/UpdateApiSpecRequest.php @@ -18,7 +18,7 @@ class UpdateApiSpecRequest extends \Google\Protobuf\Internal\Message /** * Required. The spec to update. * The `name` field is used to identify the spec to update. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiSpec api_spec = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -26,8 +26,8 @@ class UpdateApiSpecRequest extends \Google\Protobuf\Internal\Message /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; */ @@ -49,12 +49,12 @@ class UpdateApiSpecRequest extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\ApigeeRegistry\V1\ApiSpec $api_spec * Required. The spec to update. * The `name` field is used to identify the spec to update. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * @type \Google\Protobuf\FieldMask $update_mask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allow_missing * If set to true, and the spec is not found, a new spec will be created. * In this situation, `update_mask` is ignored. @@ -68,7 +68,7 @@ public function __construct($data = NULL) { /** * Required. The spec to update. * The `name` field is used to identify the spec to update. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiSpec api_spec = 1 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\ApigeeRegistry\V1\ApiSpec|null @@ -91,7 +91,7 @@ public function clearApiSpec() /** * Required. The spec to update. * The `name` field is used to identify the spec to update. - * Format: projects/*/locations/*/apis/*/versions/*/specs/* + * Format: `projects/*/locations/*/apis/*/versions/*/specs/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiSpec api_spec = 1 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\ApigeeRegistry\V1\ApiSpec $var @@ -108,8 +108,8 @@ public function setApiSpec($var) /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @return \Google\Protobuf\FieldMask|null @@ -132,8 +132,8 @@ public function clearUpdateMask() /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @param \Google\Protobuf\FieldMask $var diff --git a/ApigeeRegistry/src/V1/UpdateApiVersionRequest.php b/ApigeeRegistry/src/V1/UpdateApiVersionRequest.php index 0f57cb639dbe..28bf752bafce 100644 --- a/ApigeeRegistry/src/V1/UpdateApiVersionRequest.php +++ b/ApigeeRegistry/src/V1/UpdateApiVersionRequest.php @@ -18,7 +18,7 @@ class UpdateApiVersionRequest extends \Google\Protobuf\Internal\Message /** * Required. The version to update. * The `name` field is used to identify the version to update. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiVersion api_version = 1 [(.google.api.field_behavior) = REQUIRED]; */ @@ -26,8 +26,8 @@ class UpdateApiVersionRequest extends \Google\Protobuf\Internal\Message /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; */ @@ -49,12 +49,12 @@ class UpdateApiVersionRequest extends \Google\Protobuf\Internal\Message * @type \Google\Cloud\ApigeeRegistry\V1\ApiVersion $api_version * Required. The version to update. * The `name` field is used to identify the version to update. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * @type \Google\Protobuf\FieldMask $update_mask * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * @type bool $allow_missing * If set to true, and the version is not found, a new version will be * created. In this situation, `update_mask` is ignored. @@ -68,7 +68,7 @@ public function __construct($data = NULL) { /** * Required. The version to update. * The `name` field is used to identify the version to update. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiVersion api_version = 1 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\ApigeeRegistry\V1\ApiVersion|null @@ -91,7 +91,7 @@ public function clearApiVersion() /** * Required. The version to update. * The `name` field is used to identify the version to update. - * Format: projects/*/locations/*/apis/*/versions/* + * Format: `projects/*/locations/*/apis/*/versions/*` * * Generated from protobuf field .google.cloud.apigeeregistry.v1.ApiVersion api_version = 1 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\ApigeeRegistry\V1\ApiVersion $var @@ -108,8 +108,8 @@ public function setApiVersion($var) /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @return \Google\Protobuf\FieldMask|null @@ -132,8 +132,8 @@ public function clearUpdateMask() /** * The list of fields to be updated. If omitted, all fields are updated that * are set in the request message (fields set to default values are ignored). - * If a "*" is specified, all fields are updated, including fields that are - * unspecified/default in the request. + * If an asterisk "*" is specified, all fields are updated, including fields + * that are unspecified/default in the request. * * Generated from protobuf field .google.protobuf.FieldMask update_mask = 2; * @param \Google\Protobuf\FieldMask $var