update API descriptions

This commit is contained in:
Sebastian Thiel
2020-07-10 09:11:32 +08:00
parent b6ee34dcff
commit 69fb05c4e1
271 changed files with 82506 additions and 23249 deletions

View File

@@ -194,12 +194,12 @@
],
"parameters": {
"instanceId": {
"description": "The name of the instance to create.\nThe name must be unique for the specified project and location.",
"description": "Required. The name of the instance to create.\nThe name must be unique for the specified project and location.",
"location": "query",
"type": "string"
},
"parent": {
"description": "The instance's project and location, in the format\nprojects/{project_id}/locations/{location}. In Cloud Filestore,\nlocations map to GCP zones, for example **us-west1-b**.",
"description": "Required. The instance's project and location, in the format\nprojects/{project_id}/locations/{location}. In Cloud Filestore,\nlocations map to GCP zones, for example **us-west1-b**.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
@@ -227,7 +227,7 @@
],
"parameters": {
"name": {
"description": "The instance resource name, in the format\nprojects/{project_id}/locations/{location}/instances/{instance_id}",
"description": "Required. The instance resource name, in the format\nprojects/{project_id}/locations/{location}/instances/{instance_id}",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$",
"required": true,
@@ -252,7 +252,7 @@
],
"parameters": {
"name": {
"description": "The instance resource name, in the format\nprojects/{project_id}/locations/{location}/instances/{instance_id}.",
"description": "Required. The instance resource name, in the format\nprojects/{project_id}/locations/{location}/instances/{instance_id}.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$",
"required": true,
@@ -298,7 +298,7 @@
"type": "string"
},
"parent": {
"description": "The project and location for which to retrieve instance information,\nin the format projects/{project_id}/locations/{location}. In Cloud\nFilestore, locations map to GCP zones, for example **us-west1-b**. To\nretrieve instance information for all locations, use \"-\" for the {location}\nvalue.",
"description": "Required. The project and location for which to retrieve instance information,\nin the format projects/{project_id}/locations/{location}. In Cloud\nFilestore, locations map to GCP zones, for example **us-west1-b**. To\nretrieve instance information for all locations, use \"-\" for the {location}\nvalue.",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+$",
"required": true,
@@ -477,7 +477,7 @@
}
}
},
"revision": "20200406",
"revision": "20200707",
"rootUrl": "https://file.googleapis.com/",
"schemas": {
"CancelOperationRequest": {
@@ -541,6 +541,10 @@
"description": "The MaintenanceSchedule contains the scheduling information of published\nmaintenance schedule.",
"type": "object"
},
"maintenanceSettings": {
"$ref": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings",
"description": "Optional. The MaintenanceSettings associated with instance."
},
"name": {
"description": "Unique name of the resource. It uses the form:\n `projects/{project_id}/locations/{location_id}/instances/{instance_id}`",
"type": "string"
@@ -633,6 +637,17 @@
},
"type": "object"
},
"GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings": {
"description": "Maintenance settings associated with instance. Allows service producers and\nend users to assign settings that controls maintenance on this instance.",
"id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings",
"properties": {
"exclude": {
"description": "Optional. Exclude instance from maintenance. When true, rollout service will not\nattempt maintenance on the instance. Rollout service will include the\ninstance in reported rollout progress as not attempted.",
"type": "boolean"
}
},
"type": "object"
},
"GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata": {
"description": "Node information for custom per-node SLO implementations.\nSSA does not support per-node SLO, but producers can populate per-node\ninformation in SloMetadata for custom precomputations.\nSSA Eligibility Exporter will emit per-node metric based on this information.",
"id": "GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata",
@@ -749,7 +764,7 @@
"type": "string"
},
"description": {
"description": "Optional. The description of the instance (2048 characters or less).",
"description": "The description of the instance (2048 characters or less).",
"type": "string"
},
"etag": {
@@ -817,8 +832,8 @@
],
"enumDescriptions": [
"Not set.",
"STANDARD tier. BASIC_HDD is the preferred term for this tier.",
"PREMIUM tier. BASIC_SSD is the preferred term for this tier.",
"STANDARD tier.",
"PREMIUM tier.",
"BASIC instances offer a maximum capacity of 63.9 TB.\nBASIC_HDD is an alias for STANDARD Tier, offering economical\nperformance backed by HDD.",
"BASIC instances offer a maximum capacity of 63.9 TB.\nBASIC_SSD is an alias for PREMIUM Tier, and offers improved\nperformance backed by SSD.",
"HIGH_SCALE instances offer expanded capacity and performance scaling\ncapabilities."