| OLD | NEW |
| 1 { | 1 { |
| 2 "auth": { | 2 "auth": { |
| 3 "oauth2": { | 3 "oauth2": { |
| 4 "scopes": { | 4 "scopes": { |
| 5 "https://www.googleapis.com/auth/cloud-platform": { | 5 "https://www.googleapis.com/auth/cloud-platform": { |
| 6 "description": "View and manage your data across Google Clou
d Platform services" | 6 "description": "View and manage your data across Google Clou
d Platform services" |
| 7 }, | 7 }, |
| 8 "https://www.googleapis.com/auth/cloudruntimeconfig": { | 8 "https://www.googleapis.com/auth/cloudruntimeconfig": { |
| 9 "description": "Manage your Google Cloud Platform services'
runtime configuration" | 9 "description": "Manage your Google Cloud Platform services'
runtime configuration" |
| 10 } | 10 } |
| (...skipping 344 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 355 "path": "v1beta1/{+name}", | 355 "path": "v1beta1/{+name}", |
| 356 "response": { | 356 "response": { |
| 357 "$ref": "Variable" | 357 "$ref": "Variable" |
| 358 }, | 358 }, |
| 359 "scopes": [ | 359 "scopes": [ |
| 360 "https://www.googleapis.com/auth/cloud-p
latform", | 360 "https://www.googleapis.com/auth/cloud-p
latform", |
| 361 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 361 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
| 362 ] | 362 ] |
| 363 }, | 363 }, |
| 364 "create": { | 364 "create": { |
| 365 "description": "Creates a variable within th
e given configuration. You cannot create\na variable with a name that is a prefi
x of an existing variable name, or a\nname that has an existing variable name as
a prefix.\n\nTo learn more about creating a variable, read the\n[Setting and Ge
tting Data](/deployment-manager/runtime-configurator/seta-and-get-variables)\ndo
cumentation.", | 365 "description": "Creates a variable within th
e given configuration. You cannot create\na variable with a name that is a prefi
x of an existing variable name, or a\nname that has an existing variable name as
a prefix.\n\nTo learn more about creating a variable, read the\n[Setting and Ge
tting Data](/deployment-manager/runtime-configurator/set-and-get-variables)\ndoc
umentation.", |
| 366 "httpMethod": "POST", | 366 "httpMethod": "POST", |
| 367 "id": "runtimeconfig.projects.configs.variab
les.create", | 367 "id": "runtimeconfig.projects.configs.variab
les.create", |
| 368 "parameterOrder": [ | 368 "parameterOrder": [ |
| 369 "parent" | 369 "parent" |
| 370 ], | 370 ], |
| 371 "parameters": { | 371 "parameters": { |
| 372 "parent": { | 372 "parent": { |
| 373 "description": "The path to the Ruti
meConfig resource that this variable should belong to.\nThe configuration must e
xist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/confi
gs/[CONFIG_NAME]`", | 373 "description": "The path to the Ruti
meConfig resource that this variable should belong to.\nThe configuration must e
xist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/confi
gs/[CONFIG_NAME]`", |
| 374 "location": "path", | 374 "location": "path", |
| 375 "pattern": "^projects/[^/]*/configs/
[^/]*$", | 375 "pattern": "^projects/[^/]*/configs/
[^/]*$", |
| (...skipping 218 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 594 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 594 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
| 595 ] | 595 ] |
| 596 } | 596 } |
| 597 } | 597 } |
| 598 } | 598 } |
| 599 } | 599 } |
| 600 } | 600 } |
| 601 } | 601 } |
| 602 } | 602 } |
| 603 }, | 603 }, |
| 604 "revision": "20160627", | 604 "revision": "20160801", |
| 605 "rootUrl": "https://runtimeconfig.googleapis.com/", | 605 "rootUrl": "https://runtimeconfig.googleapis.com/", |
| 606 "schemas": { | 606 "schemas": { |
| 607 "Status": { | 607 "Status": { |
| 608 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` which can be used for common error conditions.\n\n# Lan
guage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mes
sage is\nexposed in different client libraries and different wire protocols, it
can be\nmapped differently. For example, it will likely be mapped to some except
ions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\
n\nThe error model and the `Status` message can be used in a variety of\nenviron
ments, either with or without APIs, to provide a\nconsistent developer experienc
e across different environments.\n\nExample uses of this error model include:\n\
n- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step
may\n have a `Status` message for error reporting purpose.\n\n- Batch operati
ons. If a client uses batch request and batch response, the\n `Status` messag
e should be used directly inside batch response, one for\n each error sub-res
ponse.\n\n- Asynchronous operations. If an API call embeds asynchronous operatio
n\n results in its response, the status of those operations should be\n re
presented directly using the `Status` message.\n\n- Logging. If some API errors
are stored in logs, the message `Status` could\n be used directly after any s
tripping needed for security/privacy reasons.", | 608 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` which can be used for common error conditions.\n\n# Lan
guage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mes
sage is\nexposed in different client libraries and different wire protocols, it
can be\nmapped differently. For example, it will likely be mapped to some except
ions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\
n\nThe error model and the `Status` message can be used in a variety of\nenviron
ments, either with or without APIs, to provide a\nconsistent developer experienc
e across different environments.\n\nExample uses of this error model include:\n\
n- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step
may\n have a `Status` message for error reporting purpose.\n\n- Batch operati
ons. If a client uses batch request and batch response, the\n `Status` messag
e should be used directly inside batch response, one for\n each error sub-res
ponse.\n\n- Asynchronous operations. If an API call embeds asynchronous operatio
n\n results in its response, the status of those operations should be\n re
presented directly using the `Status` message.\n\n- Logging. If some API errors
are stored in logs, the message `Status` could\n be used directly after any s
tripping needed for security/privacy reasons.", |
| 609 "id": "Status", | 609 "id": "Status", |
| 610 "properties": { | 610 "properties": { |
| 611 "code": { | 611 "code": { |
| 612 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", | 612 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", |
| 613 "format": "int32", | 613 "format": "int32", |
| 614 "type": "integer" | 614 "type": "integer" |
| 615 }, | 615 }, |
| 616 "details": { | 616 "details": { |
| 617 "description": "A list of messages that carry the error deta
ils. There will be a\ncommon set of message types for APIs to use.", | 617 "description": "A list of messages that carry the error deta
ils. There will be a\ncommon set of message types for APIs to use.", |
| 618 "items": { | 618 "items": { |
| 619 "additionalProperties": { | 619 "additionalProperties": { |
| 620 "description": "Properties of the object. Contains f
ield @ype with type URL.", | 620 "description": "Properties of the object. Contains f
ield @type with type URL.", |
| 621 "type": "any" | 621 "type": "any" |
| 622 }, | 622 }, |
| 623 "type": "object" | 623 "type": "object" |
| 624 }, | 624 }, |
| 625 "type": "array" | 625 "type": "array" |
| 626 }, | 626 }, |
| 627 "message": { | 627 "message": { |
| 628 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", | 628 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", |
| 629 "type": "string" | 629 "type": "string" |
| 630 } | 630 } |
| (...skipping 16 matching lines...) Expand all Loading... |
| 647 "type": "array" | 647 "type": "array" |
| 648 } | 648 } |
| 649 }, | 649 }, |
| 650 "type": "object" | 650 "type": "object" |
| 651 }, | 651 }, |
| 652 "Variable": { | 652 "Variable": { |
| 653 "description": "Describes a single variable within a RuntimeConfig r
esource.\nThe name denotes the hierarchical variable name. For example,\n`ports/
serving_port` is a valid variable name. The variable value is an\nopaque string
and only leaf variables can have values (that is, variables\nthat do not have an
y child variables).", | 653 "description": "Describes a single variable within a RuntimeConfig r
esource.\nThe name denotes the hierarchical variable name. For example,\n`ports/
serving_port` is a valid variable name. The variable value is an\nopaque string
and only leaf variables can have values (that is, variables\nthat do not have an
y child variables).", |
| 654 "id": "Variable", | 654 "id": "Variable", |
| 655 "properties": { | 655 "properties": { |
| 656 "value": { | 656 "value": { |
| 657 "description": "The value of the variable. The length of the
value must be less than 4096\nbytes. Empty values are also accepted. The value
must be Base64 encoded.", | 657 "description": "The binary value of the variable. The length
of the value must be less\nthan 4096 bytes. Empty values are also accepted. The
value must be\nBase64 encoded.\nNB: Only one of value and string_value can be s
et at the same time.", |
| 658 "format": "byte", | 658 "format": "byte", |
| 659 "type": "string" | 659 "type": "string" |
| 660 }, | 660 }, |
| 661 "text": { |
| 662 "description": "The textual value of the variable. The lengt
h of the value must be less\nthan 4096 bytes. Empty values are also accepted.\nN
B: Only one of value and string_value can be set at the same time.", |
| 663 "type": "string" |
| 664 }, |
| 661 "updateTime": { | 665 "updateTime": { |
| 662 "description": "[Output Only] The time of the last variable
update.", | 666 "description": "[Output Only] The time of the last variable
update.", |
| 663 "format": "google-datetime", | 667 "format": "google-datetime", |
| 664 "type": "string" | 668 "type": "string" |
| 665 }, | 669 }, |
| 666 "state": { | 670 "state": { |
| 667 "description": "[Ouput only] The current state of the variab
le. The variable state indicates\nthe outcome of the `variables().watch` call an
d is visible through the\n`get` and `list` calls.", | 671 "description": "[Ouput only] The current state of the variab
le. The variable state indicates\nthe outcome of the `variables().watch` call an
d is visible through the\n`get` and `list` calls.", |
| 668 "enum": [ | 672 "enum": [ |
| 669 "VARIABLE_STATE_UNSPECIFIED", | 673 "VARIABLE_STATE_UNSPECIFIED", |
| 670 "UPDATED", | 674 "UPDATED", |
| (...skipping 20 matching lines...) Expand all Loading... |
| 691 "error": { | 695 "error": { |
| 692 "$ref": "Status", | 696 "$ref": "Status", |
| 693 "description": "The error result of the operation in case of
failure." | 697 "description": "The error result of the operation in case of
failure." |
| 694 }, | 698 }, |
| 695 "done": { | 699 "done": { |
| 696 "description": "If the value is `false`, it means the operat
ion is still in progress.\nIf true, the operation is completed, and either `erro
r` or `response` is\navailable.", | 700 "description": "If the value is `false`, it means the operat
ion is still in progress.\nIf true, the operation is completed, and either `erro
r` or `response` is\navailable.", |
| 697 "type": "boolean" | 701 "type": "boolean" |
| 698 }, | 702 }, |
| 699 "metadata": { | 703 "metadata": { |
| 700 "additionalProperties": { | 704 "additionalProperties": { |
| 701 "description": "Properties of the object. Contains field
@ype with type URL.", | 705 "description": "Properties of the object. Contains field
@type with type URL.", |
| 702 "type": "any" | 706 "type": "any" |
| 703 }, | 707 }, |
| 704 "description": "Service-specific metadata associated with th
e operation. It typically\ncontains progress information and common metadata su
ch as create time.\nSome services might not provide such metadata. Any method t
hat returns a\nlong-running operation should document the metadata type, if any.
", | 708 "description": "Service-specific metadata associated with th
e operation. It typically\ncontains progress information and common metadata su
ch as create time.\nSome services might not provide such metadata. Any method t
hat returns a\nlong-running operation should document the metadata type, if any.
", |
| 705 "type": "object" | 709 "type": "object" |
| 706 }, | 710 }, |
| 707 "response": { | 711 "response": { |
| 708 "additionalProperties": { | 712 "additionalProperties": { |
| 709 "description": "Properties of the object. Contains field
@ype with type URL.", | 713 "description": "Properties of the object. Contains field
@type with type URL.", |
| 710 "type": "any" | 714 "type": "any" |
| 711 }, | 715 }, |
| 712 "description": "The normal response of the operation in case
of success. If the original\nmethod returns no data on success, such as `Delet
e`, the response is\n`google.protobuf.Empty`. If the original method is standar
d\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmet
hods, the response should have the type `XxxResponse`, where `Xxx`\nis the origi
nal method name. For example, if the original method name\nis `TakeSnapshot()`,
the inferred response type is\n`TakeSnapshotResponse`.", | 716 "description": "The normal response of the operation in case
of success. If the original\nmethod returns no data on success, such as `Delet
e`, the response is\n`google.protobuf.Empty`. If the original method is standar
d\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmet
hods, the response should have the type `XxxResponse`, where `Xxx`\nis the origi
nal method name. For example, if the original method name\nis `TakeSnapshot()`,
the inferred response type is\n`TakeSnapshotResponse`.", |
| 713 "type": "object" | 717 "type": "object" |
| 714 }, | 718 }, |
| 715 "name": { | 719 "name": { |
| 716 "description": "The server-assigned name, which is only uniq
ue within the same service that\noriginally returns it. If you use the default H
TTP mapping, the\n`name` should have the format of `operations/some/unique/name`
.", | 720 "description": "The server-assigned name, which is only uniq
ue within the same service that\noriginally returns it. If you use the default H
TTP mapping, the\n`name` should have the format of `operations/some/unique/name`
.", |
| 717 "type": "string" | 721 "type": "string" |
| 718 } | 722 } |
| 719 }, | 723 }, |
| 720 "type": "object" | 724 "type": "object" |
| 721 }, | 725 }, |
| 722 "Waiter": { | 726 "Waiter": { |
| 723 "description": "A Waiter resource waits for some end condition withi
n a RuntimeConfig resource\nto be met before it returns. For example, assume you
have a distributed\nsystem where each node writes to a Variable resource indidi
cating the node's\nreadiness as part of the startup process.\n\nYou then configu
re a Waiter resource with the success condition set to wait\nuntil some number o
f nodes have checked in. Afterwards, your application\nruns some arbitrary code
after the condition has been met and the waiter\nreturns successfully.\n\nOnce c
reated, a Waiter resource is immutable.\n\nTo learn more about using waiters, re
ad the\n[Creating a Waiter](/deployment-manager/runtime-config/creating-a-water)
\ndocumentation.", | 727 "description": "A Waiter resource waits for some end condition withi
n a RuntimeConfig resource\nto be met before it returns. For example, assume you
have a distributed\nsystem where each node writes to a Variable resource indidi
cating the node's\nreadiness as part of the startup process.\n\nYou then configu
re a Waiter resource with the success condition set to wait\nuntil some number o
f nodes have checked in. Afterwards, your application\nruns some arbitrary code
after the condition has been met and the waiter\nreturns successfully.\n\nOnce c
reated, a Waiter resource is immutable.\n\nTo learn more about using waiters, re
ad the\n[Creating a Waiter](/deployment-manager/runtime-configurator/creating-a-
waiter)\ndocumentation.", |
| 724 "id": "Waiter", | 728 "id": "Waiter", |
| 725 "properties": { | 729 "properties": { |
| 726 "timeout": { | 730 "timeout": { |
| 727 "description": "[Required] Specifies the timeout of the wait
er in seconds, beginning from\nthe instant that `waiters().create` method is cal
led. If this time elapses\nbefore the success or failure conditions are met, the
waiter fails and sets\nthe `error` code to `DEADLINE_EXCEEDED`.", | 731 "description": "[Required] Specifies the timeout of the wait
er in seconds, beginning from\nthe instant that `waiters().create` method is cal
led. If this time elapses\nbefore the success or failure conditions are met, the
waiter fails and sets\nthe `error` code to `DEADLINE_EXCEEDED`.", |
| 728 "format": "google-duration", | 732 "format": "google-duration", |
| 729 "type": "string" | 733 "type": "string" |
| 730 }, | 734 }, |
| 731 "success": { | 735 "success": { |
| 732 "$ref": "EndCondition", | 736 "$ref": "EndCondition", |
| 733 "description": "[Required] The success condition. If this co
ndition is met, `done` will be\nset to `true` and the `error` value will remain
unset. The failure condition\ntakes precedence over the success condition. If bo
th conditions are met, a\nfailure will be indicated." | 737 "description": "[Required] The success condition. If this co
ndition is met, `done` will be\nset to `true` and the `error` value will remain
unset. The failure condition\ntakes precedence over the success condition. If bo
th conditions are met, a\nfailure will be indicated." |
| 734 }, | 738 }, |
| 735 "failure": { | 739 "failure": { |
| 736 "$ref": "EndCondition", | 740 "$ref": "EndCondition", |
| 737 "description": "[Optional] The failure condition of this wai
ter. If this condition is met,\n`done` will be set to `true` and the `error` cod
e will be set to `ABORTED`.\nThe failure condition takes precedence over the suc
cess condition. If both\nconditions are met, a failure will be indicated. This v
alue is optional; if\nno failure condition is set, the only failure scenario wil
l be a timeout." | 741 "description": "[Optional] The failure condition of this wai
ter. If this condition is met,\n`done` will be set to `true` and the `error` cod
e will be set to `ABORTED`.\nThe failure condition takes precedence over the suc
cess condition. If both\nconditions are met, a failure will be indicated. This v
alue is optional; if\nno failure condition is set, the only failure scenario wil
l be a timeout." |
| 738 }, | 742 }, |
| 739 "createTime": { | 743 "createTime": { |
| 740 "description": "[Output Only] The instant at which this Wait
er resource was created. Adding\nthe value of `timeout` to this instant yields t
he timeout deadline for the\nwaiter.", | 744 "description": "[Output Only] The instant at which this Wait
er resource was created. Adding\nthe value of `timeout` to this instant yields t
he timeout deadline for the\nwaiter.", |
| 741 "format": "google-datetime", | 745 "format": "google-datetime", |
| 742 "type": "string" | 746 "type": "string" |
| 743 }, | 747 }, |
| 744 "name": { | 748 "name": { |
| 745 "description": "The name of the Waiter resource, in the form
at:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]\n\n
The `[PROJECT_ID]` must be a valid Google Cloud project ID,\nthe `[CONFIG_NAME]`
must be a valid RuntimeConfig resource, the\n`[WAITER_NAME]` must match RFC 103
5 segment specification, and the length\nof `[WAITER_NAME]` must be less than 64
bytes.\n\nAfter you create a Waiter resource, you cannot change the resource na
me.", | 749 "description": "The name of the Waiter resource, in the form
at:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]\n\n
The `[PROJECT_ID]` must be a valid Google Cloud project ID,\nthe `[CONFIG_NAME]`
must be a valid RuntimeConfig resource, the\n`[WAITER_NAME]` must match RFC 103
5 segment specification, and the length\nof `[WAITER_NAME]` must be less than 64
bytes.\n\nAfter you create a Waiter resource, you cannot change the resource na
me.", |
| 746 "type": "string" | 750 "type": "string" |
| 747 }, | 751 }, |
| 748 "error": { | 752 "error": { |
| 749 "$ref": "Status", | 753 "$ref": "Status", |
| 750 "description": "[Output Only] If the waiter ended due to a f
ailure or timeout, this value\nwill be set.\n" | 754 "description": "[Output Only] If the waiter ended due to a f
ailure or timeout, this value\nwill be set." |
| 751 }, | 755 }, |
| 752 "done": { | 756 "done": { |
| 753 "description": "[Output Only] If the value is `false`, it me
ans the waiter is still waiting\nfor one of its conditions to be met.\n\nIf true
, the waiter has finished. If the waiter finished due to a timeout\nor failure,
`error` will be set.", | 757 "description": "[Output Only] If the value is `false`, it me
ans the waiter is still waiting\nfor one of its conditions to be met.\n\nIf true
, the waiter has finished. If the waiter finished due to a timeout\nor failure,
`error` will be set.", |
| 754 "type": "boolean" | 758 "type": "boolean" |
| 755 } | 759 } |
| 756 }, | 760 }, |
| 757 "type": "object" | 761 "type": "object" |
| 758 }, | 762 }, |
| 759 "RuntimeConfig": { | 763 "RuntimeConfig": { |
| 760 "description": "A RuntimeConfig resource is the primary resource in
the Cloud RuntimeConfig\nservice. A RuntimeConfig resource consists of metadata
and a hierarchy of\nvariables.", | 764 "description": "A RuntimeConfig resource is the primary resource in
the Cloud RuntimeConfig\nservice. A RuntimeConfig resource consists of metadata
and a hierarchy of\nvariables.", |
| (...skipping 89 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 850 "type": "string" | 854 "type": "string" |
| 851 } | 855 } |
| 852 }, | 856 }, |
| 853 "type": "object" | 857 "type": "object" |
| 854 } | 858 } |
| 855 }, | 859 }, |
| 856 "servicePath": "", | 860 "servicePath": "", |
| 857 "title": "Google Cloud RuntimeConfig API", | 861 "title": "Google Cloud RuntimeConfig API", |
| 858 "version": "v1beta1" | 862 "version": "v1beta1" |
| 859 } | 863 } |
| OLD | NEW |