restic/vendor/google.golang.org/api/appengine/v1alpha/appengine-api.json

1303 lines
56 KiB
JSON
Raw Normal View History

2017-08-05 18:17:15 +00:00
{
"discoveryVersion": "v1",
"ownerName": "Google",
"resources": {
"apps": {
"resources": {
"authorizedCertificates": {
"methods": {
"delete": {
"description": "Deletes the specified SSL certificate.",
"response": {
"$ref": "Empty"
},
"parameterOrder": [
"appsId",
"authorizedCertificatesId"
],
"httpMethod": "DELETE",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
],
"parameters": {
"authorizedCertificatesId": {
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true,
"location": "path"
},
"appsId": {
"location": "path",
"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/authorizedCertificates/12345.",
"type": "string",
"required": true
}
},
"flatPath": "v1alpha/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}",
"id": "appengine.apps.authorizedCertificates.delete",
"path": "v1alpha/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}"
},
"patch": {
"httpMethod": "PATCH",
"parameterOrder": [
"appsId",
"authorizedCertificatesId"
],
"response": {
"$ref": "AuthorizedCertificate"
},
"parameters": {
"authorizedCertificatesId": {
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true,
"location": "path"
},
"updateMask": {
"location": "query",
"format": "google-fieldmask",
"description": "Standard field mask for the set of fields to be updated. Updates are only supported on the certificate_raw_data and display_name fields.",
"type": "string"
},
"appsId": {
"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/authorizedCertificates/12345.",
"type": "string",
"required": true,
"location": "path"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
],
"flatPath": "v1alpha/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}",
"path": "v1alpha/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}",
"id": "appengine.apps.authorizedCertificates.patch",
"description": "Updates the specified SSL certificate. To renew a certificate and maintain its existing domain mappings, update certificate_data with a new certificate. The new certificate must be applicable to the same domains as the original certificate. The certificate display_name may also be updated.",
"request": {
"$ref": "AuthorizedCertificate"
}
},
"get": {
"description": "Gets the specified SSL certificate.",
"httpMethod": "GET",
"response": {
"$ref": "AuthorizedCertificate"
},
"parameterOrder": [
"appsId",
"authorizedCertificatesId"
],
"parameters": {
"appsId": {
"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/authorizedCertificates/12345.",
"type": "string",
"required": true,
"location": "path"
},
"view": {
"location": "query",
"enum": [
"BASIC_CERTIFICATE",
"FULL_CERTIFICATE"
],
"description": "Controls the set of fields returned in the GET response.",
"type": "string"
},
"authorizedCertificatesId": {
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true,
"location": "path"
}
},
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"flatPath": "v1alpha/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}",
"path": "v1alpha/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}",
"id": "appengine.apps.authorizedCertificates.get"
},
"list": {
"response": {
"$ref": "ListAuthorizedCertificatesResponse"
},
"parameterOrder": [
"appsId"
],
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"parameters": {
"pageToken": {
"description": "Continuation token for fetching the next page of results.",
"type": "string",
"location": "query"
},
"appsId": {
"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
"type": "string",
"required": true,
"location": "path"
},
"pageSize": {
"location": "query",
"format": "int32",
"description": "Maximum results to return per page.",
"type": "integer"
},
"view": {
"location": "query",
"enum": [
"BASIC_CERTIFICATE",
"FULL_CERTIFICATE"
],
"description": "Controls the set of fields returned in the LIST response.",
"type": "string"
}
},
"flatPath": "v1alpha/apps/{appsId}/authorizedCertificates",
"id": "appengine.apps.authorizedCertificates.list",
"path": "v1alpha/apps/{appsId}/authorizedCertificates",
"description": "Lists all SSL certificates the user is authorized to administer."
},
"create": {
"response": {
"$ref": "AuthorizedCertificate"
},
"parameterOrder": [
"appsId"
],
"httpMethod": "POST",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
],
"parameters": {
"appsId": {
"location": "path",
"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
"type": "string",
"required": true
}
},
"flatPath": "v1alpha/apps/{appsId}/authorizedCertificates",
"id": "appengine.apps.authorizedCertificates.create",
"path": "v1alpha/apps/{appsId}/authorizedCertificates",
"request": {
"$ref": "AuthorizedCertificate"
},
"description": "Uploads the specified SSL certificate."
}
}
},
"authorizedDomains": {
"methods": {
"list": {
"flatPath": "v1alpha/apps/{appsId}/authorizedDomains",
"path": "v1alpha/apps/{appsId}/authorizedDomains",
"id": "appengine.apps.authorizedDomains.list",
"description": "Lists all domains the user is authorized to administer.",
"httpMethod": "GET",
"parameterOrder": [
"appsId"
],
"response": {
"$ref": "ListAuthorizedDomainsResponse"
},
"parameters": {
"pageToken": {
"description": "Continuation token for fetching the next page of results.",
"type": "string",
"location": "query"
},
"appsId": {
"location": "path",
"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
"type": "string",
"required": true
},
"pageSize": {
"location": "query",
"format": "int32",
"description": "Maximum results to return per page.",
"type": "integer"
}
},
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
]
}
}
},
"operations": {
"methods": {
"get": {
"response": {
"$ref": "Operation"
},
"parameterOrder": [
"appsId",
"operationsId"
],
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"parameters": {
"appsId": {
"description": "Part of `name`. The name of the operation resource.",
"type": "string",
"required": true,
"location": "path"
},
"operationsId": {
"location": "path",
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true
}
},
"flatPath": "v1alpha/apps/{appsId}/operations/{operationsId}",
"id": "appengine.apps.operations.get",
"path": "v1alpha/apps/{appsId}/operations/{operationsId}",
"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service."
},
"list": {
"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding allows API services to override the binding to use different resource name schemes, such as users/*/operations. To override the binding, API services can add a binding such as \"/v1/{name=users/*}/operations\" to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.",
"response": {
"$ref": "ListOperationsResponse"
},
"parameterOrder": [
"appsId"
],
"httpMethod": "GET",
"parameters": {
"filter": {
"location": "query",
"description": "The standard list filter.",
"type": "string"
},
"pageToken": {
"location": "query",
"description": "The standard list page token.",
"type": "string"
},
"appsId": {
"location": "path",
"description": "Part of `name`. The name of the operation's parent resource.",
"type": "string",
"required": true
},
"pageSize": {
"format": "int32",
"description": "The standard list page size.",
"type": "integer",
"location": "query"
}
},
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"flatPath": "v1alpha/apps/{appsId}/operations",
"id": "appengine.apps.operations.list",
"path": "v1alpha/apps/{appsId}/operations"
}
}
},
"locations": {
"methods": {
"get": {
"description": "Get information about a location.",
"response": {
"$ref": "Location"
},
"parameterOrder": [
"appsId",
"locationsId"
],
"httpMethod": "GET",
"parameters": {
"locationsId": {
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true,
"location": "path"
},
"appsId": {
"description": "Part of `name`. Resource name for the location.",
"type": "string",
"required": true,
"location": "path"
}
},
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"flatPath": "v1alpha/apps/{appsId}/locations/{locationsId}",
"id": "appengine.apps.locations.get",
"path": "v1alpha/apps/{appsId}/locations/{locationsId}"
},
"list": {
"httpMethod": "GET",
"parameterOrder": [
"appsId"
],
"response": {
"$ref": "ListLocationsResponse"
},
"parameters": {
"pageToken": {
"location": "query",
"description": "The standard list page token.",
"type": "string"
},
"appsId": {
"location": "path",
"description": "Part of `name`. The resource that owns the locations collection, if applicable.",
"type": "string",
"required": true
},
"pageSize": {
"location": "query",
"format": "int32",
"description": "The standard list page size.",
"type": "integer"
},
"filter": {
"description": "The standard list filter.",
"type": "string",
"location": "query"
}
},
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"flatPath": "v1alpha/apps/{appsId}/locations",
"path": "v1alpha/apps/{appsId}/locations",
"id": "appengine.apps.locations.list",
"description": "Lists information about the supported locations for this service."
}
}
},
"domainMappings": {
"methods": {
"delete": {
"description": "Deletes the specified domain mapping. A user must be authorized to administer the associated domain in order to delete a DomainMapping resource.",
"response": {
"$ref": "Operation"
},
"parameterOrder": [
"appsId",
"domainMappingsId"
],
"httpMethod": "DELETE",
"parameters": {
"domainMappingsId": {
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true,
"location": "path"
},
"appsId": {
"location": "path",
"description": "Part of `name`. Name of the resource to delete. Example: apps/myapp/domainMappings/example.com.",
"type": "string",
"required": true
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
],
"flatPath": "v1alpha/apps/{appsId}/domainMappings/{domainMappingsId}",
"id": "appengine.apps.domainMappings.delete",
"path": "v1alpha/apps/{appsId}/domainMappings/{domainMappingsId}"
},
"patch": {
"response": {
"$ref": "Operation"
},
"parameterOrder": [
"appsId",
"domainMappingsId"
],
"httpMethod": "PATCH",
"parameters": {
"domainMappingsId": {
"location": "path",
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true
},
"noManagedCertificate": {
"location": "query",
"description": "Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated. Only applicable if ssl_settings.certificate_id is specified in the update mask.",
"type": "boolean"
},
"updateMask": {
"format": "google-fieldmask",
"description": "Standard field mask for the set of fields to be updated.",
"type": "string",
"location": "query"
},
"appsId": {
"description": "Part of `name`. Name of the resource to update. Example: apps/myapp/domainMappings/example.com.",
"type": "string",
"required": true,
"location": "path"
}
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
],
"flatPath": "v1alpha/apps/{appsId}/domainMappings/{domainMappingsId}",
"id": "appengine.apps.domainMappings.patch",
"path": "v1alpha/apps/{appsId}/domainMappings/{domainMappingsId}",
"description": "Updates the specified domain mapping. To map an SSL certificate to a domain mapping, update certificate_id to point to an AuthorizedCertificate resource. A user must be authorized to administer the associated domain in order to update a DomainMapping resource.",
"request": {
"$ref": "DomainMapping"
}
},
"get": {
"flatPath": "v1alpha/apps/{appsId}/domainMappings/{domainMappingsId}",
"path": "v1alpha/apps/{appsId}/domainMappings/{domainMappingsId}",
"id": "appengine.apps.domainMappings.get",
"description": "Gets the specified domain mapping.",
"httpMethod": "GET",
"parameterOrder": [
"appsId",
"domainMappingsId"
],
"response": {
"$ref": "DomainMapping"
},
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"parameters": {
"domainMappingsId": {
"description": "Part of `name`. See documentation of `appsId`.",
"type": "string",
"required": true,
"location": "path"
},
"appsId": {
"location": "path",
"description": "Part of `name`. Name of the resource requested. Example: apps/myapp/domainMappings/example.com.",
"type": "string",
"required": true
}
}
},
"list": {
"description": "Lists the domain mappings on an application.",
"response": {
"$ref": "ListDomainMappingsResponse"
},
"parameterOrder": [
"appsId"
],
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/appengine.admin",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform.read-only"
],
"parameters": {
"pageToken": {
"location": "query",
"description": "Continuation token for fetching the next page of results.",
"type": "string"
},
"appsId": {
"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
"type": "string",
"required": true,
"location": "path"
},
"pageSize": {
"format": "int32",
"description": "Maximum results to return per page.",
"type": "integer",
"location": "query"
}
},
"flatPath": "v1alpha/apps/{appsId}/domainMappings",
"id": "appengine.apps.domainMappings.list",
"path": "v1alpha/apps/{appsId}/domainMappings"
},
"create": {
"request": {
"$ref": "DomainMapping"
},
"description": "Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.",
"httpMethod": "POST",
"parameterOrder": [
"appsId"
],
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
],
"parameters": {
"noManagedCertificate": {
"location": "query",
"description": "Whether a managed certificate should be provided by App Engine. If true, a certificate ID must be manaually set in the DomainMapping resource to configure SSL for this domain. If false, a managed certificate will be provisioned and a certificate ID will be automatically populated.",
"type": "boolean"
},
"appsId": {
"description": "Part of `parent`. Name of the parent Application resource. Example: apps/myapp.",
"type": "string",
"required": true,
"location": "path"
}
},
"flatPath": "v1alpha/apps/{appsId}/domainMappings",
"path": "v1alpha/apps/{appsId}/domainMappings",
"id": "appengine.apps.domainMappings.create"
}
}
}
}
}
},
"parameters": {
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"type": "string",
"location": "query"
},
"prettyPrint": {
"description": "Returns response with indentations and line breaks.",
"default": "true",
"type": "boolean",
"location": "query"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"type": "string",
"location": "query"
},
"uploadType": {
"location": "query",
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"type": "string"
},
"callback": {
"location": "query",
"description": "JSONP",
"type": "string"
},
"$.xgafv": {
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"enum": [
"1",
"2"
],
"description": "V1 error format.",
"type": "string"
},
"alt": {
"enum": [
"json",
"media",
"proto"
],
"type": "string",
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
"description": "Data format for response.",
"default": "json"
},
"access_token": {
"location": "query",
"description": "OAuth access token.",
"type": "string"
},
"key": {
"location": "query",
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"type": "string"
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"type": "string",
"location": "query"
},
"pp": {
"description": "Pretty-print response.",
"default": "true",
"type": "boolean",
"location": "query"
},
"oauth_token": {
"location": "query",
"description": "OAuth 2.0 token for the current user.",
"type": "string"
},
"bearer_token": {
"location": "query",
"description": "OAuth bearer token.",
"type": "string"
}
},
"schemas": {
"ListAuthorizedCertificatesResponse": {
"description": "Response message for AuthorizedCertificates.ListAuthorizedCertificates.",
"type": "object",
"properties": {
"nextPageToken": {
"description": "Continuation token for fetching the next page of results.",
"type": "string"
},
"certificates": {
"description": "The SSL certificates the user is authorized to administer.",
"items": {
"$ref": "AuthorizedCertificate"
},
"type": "array"
}
},
"id": "ListAuthorizedCertificatesResponse"
},
"OperationMetadataV1Beta5": {
"description": "Metadata for the given google.longrunning.Operation.",
"type": "object",
"properties": {
"method": {
"description": "API method name that initiated this operation. Example: google.appengine.v1beta5.Version.CreateVersion.@OutputOnly",
"type": "string"
},
"insertTime": {
"format": "google-datetime",
"description": "Timestamp that this operation was created.@OutputOnly",
"type": "string"
},
"endTime": {
"format": "google-datetime",
"description": "Timestamp that this operation completed.@OutputOnly",
"type": "string"
},
"target": {
"description": "Name of the resource that this operation is acting on. Example: apps/myapp/services/default.@OutputOnly",
"type": "string"
},
"user": {
"description": "User who requested this operation.@OutputOnly",
"type": "string"
}
},
"id": "OperationMetadataV1Beta5"
},
"ListLocationsResponse": {
"description": "The response message for Locations.ListLocations.",
"type": "object",
"properties": {
"nextPageToken": {
"description": "The standard List next-page token.",
"type": "string"
},
"locations": {
"description": "A list of locations that matches the specified filter in the request.",
"items": {
"$ref": "Location"
},
"type": "array"
}
},
"id": "ListLocationsResponse"
},
"ManagedCertificate": {
"description": "A certificate managed by App Engine.",
"type": "object",
"properties": {
"lastRenewalTime": {
"format": "google-datetime",
"description": "Time at which the certificate was last renewed. The renewal process is fully managed. Certificate renewal will automatically occur before the certificate expires. Renewal errors can be tracked via ManagementStatus.@OutputOnly",
"type": "string"
},
"status": {
"description": "Status of certificate management. Refers to the most recent certificate acquisition or renewal attempt.@OutputOnly",
"type": "string",
"enumDescriptions": [
"",
"Certificate was successfully obtained and inserted into the serving system.",
"Certificate is under active attempts to acquire or renew.",
"Most recent renewal failed due to a system failure and will be retried. System failure is likely transient, and subsequent renewal attempts may succeed. The last successfully provisioned certificate may still be serving.",
"Most recent renewal failed due to an invalid DNS setup and will be retried. Renewal attempts will continue to fail until the certificate domain's DNS configuration is fixed. The last successfully provisioned certificate may still be serving.",
"All renewal attempts have been exhausted. Most recent renewal failed due to an invalid DNS setup and will not be retried. The last successfully provisioned certificate may still be serving."
],
"enum": [
"UNSPECIFIED_STATUS",
"OK",
"PENDING",
"FAILED_RETRYING_INTERNAL",
"FAILED_RETRYING_NOT_VISIBLE",
"FAILED_PERMANENTLY_NOT_VISIBLE"
]
}
},
"id": "ManagedCertificate"
},
"CertificateRawData": {
"description": "An SSL certificate obtained from a certificate authority.",
"type": "object",
"properties": {
"privateKey": {
"description": "Unencrypted PEM encoded RSA private key. This field is set once on certificate creation and then encrypted. The key size must be 2048 bits or fewer. Must include the header and footer. Example: \u003cpre\u003e -----BEGIN RSA PRIVATE KEY----- \u003cunencrypted_key_value\u003e -----END RSA PRIVATE KEY----- \u003c/pre\u003e @InputOnly",
"type": "string"
},
"publicCertificate": {
"description": "PEM encoded x.509 public key certificate. This field is set once on certificate creation. Must include the header and footer. Example: \u003cpre\u003e -----BEGIN CERTIFICATE----- \u003ccertificate_value\u003e -----END CERTIFICATE----- \u003c/pre\u003e",
"type": "string"
}
},
"id": "CertificateRawData"
},
"SslSettings": {
"description": "SSL configuration for a DomainMapping resource.",
"type": "object",
"properties": {
"isManagedCertificate": {
"description": "Whether the mapped certificate is an App Engine managed certificate. Managed certificates are created by default with a domain mapping. To opt out, specify no_managed_certificate on a CREATE or UPDATE request.@OutputOnly",
"type": "boolean"
},
"certificateId": {
"description": "ID of the AuthorizedCertificate resource configuring SSL for the application. Clearing this field will remove SSL support.By default, a managed certificate is automatically created for every domain mapping. To omit SSL support or to configure SSL manually, specify no_managed_certificate on a CREATE or UPDATE request. You must be authorized to administer the AuthorizedCertificate resource to manually map it to a DomainMapping resource. Example: 12345.",
"type": "string"
}
},
"id": "SslSettings"
},
"OperationMetadataV1": {
"description": "Metadata for the given google.longrunning.Operation.",
"type": "object",
"properties": {
"user": {
"description": "User who requested this operation.@OutputOnly",
"type": "string"
},
"target": {
"description": "Name of the resource that this operation is acting on. Example: apps/myapp/services/default.@OutputOnly",
"type": "string"
},
"ephemeralMessage": {
"description": "Ephemeral message that may change every time the operation is polled. @OutputOnly",
"type": "string"
},
"method": {
"description": "API method that initiated this operation. Example: google.appengine.v1.Versions.CreateVersion.@OutputOnly",
"type": "string"
},
"endTime": {
"format": "google-datetime",
"description": "Time that this operation completed.@OutputOnly",
"type": "string"
},
"insertTime": {
"format": "google-datetime",
"description": "Time that this operation was created.@OutputOnly",
"type": "string"
},
"warning": {
"description": "Durable messages that persist on every operation poll. @OutputOnly",
"items": {
"type": "string"
},
"type": "array"
}
},
"id": "OperationMetadataV1"
},
"Operation": {
"description": "This resource represents a long-running operation that is the result of a network API call.",
"type": "object",
"properties": {
"response": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"description": "The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.",
"type": "object"
},
"name": {
"description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.",
"type": "string"
},
"error": {
"description": "The error result of the operation in case of failure or cancellation.",
"$ref": "Status"
},
"metadata": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.",
"type": "object"
},
"done": {
"description": "If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.",
"type": "boolean"
}
},
"id": "Operation"
},
"ListDomainMappingsResponse": {
"description": "Response message for DomainMappings.ListDomainMappings.",
"type": "object",
"properties": {
"domainMappings": {
"description": "The domain mappings for the application.",
"items": {
"$ref": "DomainMapping"
},
"type": "array"
},
"nextPageToken": {
"description": "Continuation token for fetching the next page of results.",
"type": "string"
}
},
"id": "ListDomainMappingsResponse"
},
"OperationMetadataExperimental": {
"properties": {
"insertTime": {
"format": "google-datetime",
"description": "Time that this operation was created.@OutputOnly",
"type": "string"
},
"endTime": {
"format": "google-datetime",
"description": "Time that this operation completed.@OutputOnly",
"type": "string"
},
"target": {
"description": "Name of the resource that this operation is acting on. Example: apps/myapp/customDomains/example.com.@OutputOnly",
"type": "string"
},
"user": {
"description": "User who requested this operation.@OutputOnly",
"type": "string"
},
"method": {
"description": "API method that initiated this operation. Example: google.appengine.experimental.CustomDomains.CreateCustomDomain.@OutputOnly",
"type": "string"
}
},
"id": "OperationMetadataExperimental",
"description": "Metadata for the given google.longrunning.Operation.",
"type": "object"
},
"OperationMetadataV1Alpha": {
"description": "Metadata for the given google.longrunning.Operation.",
"type": "object",
"properties": {
"warning": {
"description": "Durable messages that persist on every operation poll. @OutputOnly",
"items": {
"type": "string"
},
"type": "array"
},
"insertTime": {
"format": "google-datetime",
"description": "Time that this operation was created.@OutputOnly",
"type": "string"
},
"user": {
"description": "User who requested this operation.@OutputOnly",
"type": "string"
},
"target": {
"description": "Name of the resource that this operation is acting on. Example: apps/myapp/services/default.@OutputOnly",
"type": "string"
},
"ephemeralMessage": {
"description": "Ephemeral message that may change every time the operation is polled. @OutputOnly",
"type": "string"
},
"method": {
"description": "API method that initiated this operation. Example: google.appengine.v1alpha.Versions.CreateVersion.@OutputOnly",
"type": "string"
},
"endTime": {
"format": "google-datetime",
"description": "Time that this operation completed.@OutputOnly",
"type": "string"
}
},
"id": "OperationMetadataV1Alpha"
},
"ListAuthorizedDomainsResponse": {
"properties": {
"nextPageToken": {
"description": "Continuation token for fetching the next page of results.",
"type": "string"
},
"domains": {
"description": "The authorized domains belonging to the user.",
"items": {
"$ref": "AuthorizedDomain"
},
"type": "array"
}
},
"id": "ListAuthorizedDomainsResponse",
"description": "Response message for AuthorizedDomains.ListAuthorizedDomains.",
"type": "object"
},
"Status": {
"properties": {
"details": {
"description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.",
"items": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"type": "object"
},
"type": "array"
},
"code": {
"format": "int32",
"description": "The status code, which should be an enum value of google.rpc.Code.",
"type": "integer"
},
"message": {
"description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.",
"type": "string"
}
},
"id": "Status",
"description": "The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). The error model is designed to be:\nSimple to use and understand for most users\nFlexible enough to meet unexpected needsOverviewThe Status message contains three pieces of data: error code, error message, and error details. The error code should be an enum value of google.rpc.Code, but it may accept additional error codes if needed. The error message should be a developer-facing English message that helps developers understand and resolve the error. If a localized user-facing error message is needed, put the localized message in the error details or localize it in the client. The optional error details may contain arbitrary information about the error. There is a predefined set of error detail types in the package google.rpc that can be used for common error conditions.Language mappingThe Status message is the logical representation of the error model, but it is not necessarily the actual wire format. When the Status message is exposed in different client libraries and different wire protocols, it can be mapped differently. For example, it will likely be mapped to some exceptions in Java, but more likely mapped to some error codes in C.Other usesThe error model and the Status message can be used in a variety of environments, either with or without APIs, to provide a consistent developer experience across different environments.Example uses of this error model include:\nPartial errors. If a service needs to return partial errors to the client, it may embed the Status in the normal response to indicate the partial errors.\nWorkflow errors. A typical workflow has multiple steps. Each step may have a Status message for error reporting.\nBatch operations. If a client uses batch request and batch response, the Status message should be used directly inside batch response, one for each error sub-response.\nAsynchronous operations. If an API call embeds asynchronous operation results in its response, the status of those operations should be represented directly using the Status message.\nLogging. If some API errors are stored in logs, the message Status could be used directly after any stripping needed for security/privacy reasons.",
"type": "object"
},
"AuthorizedDomain": {
"description": "A domain that a user has been authorized to administer. To authorize use of a domain, verify ownership via Webmaster Central (https://www.google.com/webmasters/verification/home).",
"type": "object",
"properties": {
"id": {
"description": "Fully qualified domain name of the domain authorized for use. Example: example.com.",
"type": "string"
},
"name": {
"description": "Full path to the AuthorizedDomain resource in the API. Example: apps/myapp/authorizedDomains/example.com.@OutputOnly",
"type": "string"
}
},
"id": "AuthorizedDomain"
},
"Empty": {
"description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:\nservice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n}\nThe JSON representation for Empty is empty JSON object {}.",
"type": "object",
"properties": {},
"id": "Empty"
},
"DomainMapping": {
"description": "A domain serving an App Engine application.",
"type": "object",
"properties": {
"resourceRecords": {
"description": "The resource records required to configure this domain mapping. These records must be added to the domain's DNS configuration in order to serve the application via this domain mapping.@OutputOnly",
"items": {
"$ref": "ResourceRecord"
},
"type": "array"
},
"id": {
"description": "Relative name of the domain serving the application. Example: example.com.",
"type": "string"
},
"sslSettings": {
"$ref": "SslSettings",
"description": "SSL configuration for this domain. If unconfigured, this domain will not serve with SSL."
},
"name": {
"description": "Full path to the DomainMapping resource in the API. Example: apps/myapp/domainMapping/example.com.@OutputOnly",
"type": "string"
}
},
"id": "DomainMapping"
},
"LocationMetadata": {
"properties": {
"flexibleEnvironmentAvailable": {
"description": "App Engine Flexible Environment is available in the given location.@OutputOnly",
"type": "boolean"
},
"standardEnvironmentAvailable": {
"description": "App Engine Standard Environment is available in the given location.@OutputOnly",
"type": "boolean"
}
},
"id": "LocationMetadata",
"description": "Metadata for the given google.cloud.location.Location.",
"type": "object"
},
"OperationMetadataV1Beta": {
"properties": {
"endTime": {
"format": "google-datetime",
"description": "Time that this operation completed.@OutputOnly",
"type": "string"
},
"warning": {
"description": "Durable messages that persist on every operation poll. @OutputOnly",
"items": {
"type": "string"
},
"type": "array"
},
"insertTime": {
"format": "google-datetime",
"description": "Time that this operation was created.@OutputOnly",
"type": "string"
},
"user": {
"description": "User who requested this operation.@OutputOnly",
"type": "string"
},
"target": {
"description": "Name of the resource that this operation is acting on. Example: apps/myapp/services/default.@OutputOnly",
"type": "string"
},
"ephemeralMessage": {
"description": "Ephemeral message that may change every time the operation is polled. @OutputOnly",
"type": "string"
},
"method": {
"description": "API method that initiated this operation. Example: google.appengine.v1beta.Versions.CreateVersion.@OutputOnly",
"type": "string"
}
},
"id": "OperationMetadataV1Beta",
"description": "Metadata for the given google.longrunning.Operation.",
"type": "object"
},
"Location": {
"description": "A resource that represents Google Cloud Platform location.",
"type": "object",
"properties": {
"labels": {
"description": "Cross-service attributes for the location. For example\n{\"cloud.googleapis.com/region\": \"us-east1\"}\n",
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"name": {
"description": "Resource name for the location, which may vary between implementations. For example: \"projects/example-project/locations/us-east1\"",
"type": "string"
},
"locationId": {
"description": "The canonical id for this location. For example: \"us-east1\".",
"type": "string"
},
"metadata": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"description": "Service-specific metadata. For example the available capacity at the given location.",
"type": "object"
}
},
"id": "Location"
},
"AuthorizedCertificate": {
"description": "An SSL certificate that a user has been authorized to administer. A user is authorized to administer any certificate that applies to one of their authorized domains.",
"type": "object",
"properties": {
"name": {
"description": "Full path to the AuthorizedCertificate resource in the API. Example: apps/myapp/authorizedCertificates/12345.@OutputOnly",
"type": "string"
},
"domainMappingsCount": {
"format": "int32",
"description": "Aggregate count of the domain mappings with this certificate mapped. This count includes domain mappings on applications for which the user does not have VIEWER permissions.Only returned by GET or LIST requests when specifically requested by the view=FULL_CERTIFICATE option.@OutputOnly",
"type": "integer"
},
"domainNames": {
"description": "Topmost applicable domains of this certificate. This certificate applies to these domains and their subdomains. Example: example.com.@OutputOnly",
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "Relative name of the certificate. This is a unique value autogenerated on AuthorizedCertificate resource creation. Example: 12345.@OutputOnly",
"type": "string"
},
"displayName": {
"description": "The user-specified display name of the certificate. This is not guaranteed to be unique. Example: My Certificate.",
"type": "string"
},
"certificateRawData": {
"$ref": "CertificateRawData",
"description": "The SSL certificate serving the AuthorizedCertificate resource. This must be obtained independently from a certificate authority."
},
"managedCertificate": {
"$ref": "ManagedCertificate",
"description": "Only applicable if this certificate is managed by App Engine. Managed certificates are tied to the lifecycle of a DomainMapping and cannot be updated or deleted via the AuthorizedCertificates API. If this certificate is manually administered by the user, this field will be empty.@OutputOnly"
},
"visibleDomainMappings": {
"description": "The full paths to user visible Domain Mapping resources that have this certificate mapped. Example: apps/myapp/domainMappings/example.com.This may not represent the full list of mapped domain mappings if the user does not have VIEWER permissions on all of the applications that have this certificate mapped. See domain_mappings_count for a complete count.Only returned by GET or LIST requests when specifically requested by the view=FULL_CERTIFICATE option.@OutputOnly",
"items": {
"type": "string"
},
"type": "array"
},
"expireTime": {
"format": "google-datetime",
"description": "The time when this certificate expires. To update the renewal time on this certificate, upload an SSL certificate with a different expiration time using AuthorizedCertificates.UpdateAuthorizedCertificate.@OutputOnly",
"type": "string"
}
},
"id": "AuthorizedCertificate"
},
"ResourceRecord": {
"description": "A DNS resource record.",
"type": "object",
"properties": {
"type": {
"enum": [
"A",
"AAAA",
"CNAME"
],
"description": "Resource record type. Example: AAAA.",
"type": "string",
"enumDescriptions": [
"An A resource record. Data is an IPv4 address.",
"An AAAA resource record. Data is an IPv6 address.",
"A CNAME resource record. Data is a domain name to be aliased."
]
},
"rrdata": {
"description": "Data for this record. Values vary by record type, as defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1).",
"type": "string"
},
"name": {
"description": "Relative name of the object affected by this record. Only applicable for CNAME records. Example: 'www'.",
"type": "string"
}
},
"id": "ResourceRecord"
},
"ListOperationsResponse": {
"description": "The response message for Operations.ListOperations.",
"type": "object",
"properties": {
"nextPageToken": {
"description": "The standard List next-page token.",
"type": "string"
},
"operations": {
"description": "A list of operations that matches the specified filter in the request.",
"items": {
"$ref": "Operation"
},
"type": "array"
}
},
"id": "ListOperationsResponse"
},
"OperationMetadata": {
"description": "Metadata for the given google.longrunning.Operation.",
"type": "object",
"properties": {
"insertTime": {
"format": "google-datetime",
"description": "Timestamp that this operation was created.@OutputOnly",
"type": "string"
},
"user": {
"description": "User who requested this operation.@OutputOnly",
"type": "string"
},
"target": {
"description": "Name of the resource that this operation is acting on. Example: apps/myapp/modules/default.@OutputOnly",
"type": "string"
},
"method": {
"description": "API method that initiated this operation. Example: google.appengine.v1beta4.Version.CreateVersion.@OutputOnly",
"type": "string"
},
"endTime": {
"format": "google-datetime",
"description": "Timestamp that this operation completed.@OutputOnly",
"type": "string"
},
"operationType": {
"description": "Type of this operation. Deprecated, use method field instead. Example: \"create_version\".@OutputOnly",
"type": "string"
}
},
"id": "OperationMetadata"
}
},
"protocol": "rest",
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"version": "v1alpha",
"baseUrl": "https://appengine.googleapis.com/",
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/appengine.admin": {
"description": "View and manage your applications deployed on Google App Engine"
},
"https://www.googleapis.com/auth/cloud-platform.read-only": {
"description": "View your data across Google Cloud Platform services"
},
"https://www.googleapis.com/auth/cloud-platform": {
"description": "View and manage your data across Google Cloud Platform services"
}
}
}
},
"servicePath": "",
"description": "The App Engine Admin API enables developers to provision and manage their App Engine applications.",
"kind": "discovery#restDescription",
"rootUrl": "https://appengine.googleapis.com/",
"basePath": "",
"ownerDomain": "google.com",
"name": "appengine",
"batchPath": "batch",
"id": "appengine:v1alpha",
"documentationLink": "https://cloud.google.com/appengine/docs/admin-api/",
"revision": "20170724",
"title": "Google App Engine Admin API"
}