第8章 CloudSourcesService
8.1. UpdateCloudSource
PUT /v1/cloud-sources/{cloudSource.id}
UpdateCloudSource はクラウドソースを作成または置き換えます。
8.1.1. 説明
8.1.2. パラメーター
8.1.2.1. パスパラメーター
名前 | 説明 | 必須 | デフォルト | パターン |
---|---|---|---|---|
cloudSource.id | X | null |
8.1.2.2. 本文パラメーター
名前 | 説明 | 必須 | デフォルト | パターン |
---|---|---|---|---|
body | X |
8.1.3. 戻り値のタイプ
Object
8.1.4. コンテンツタイプ
- application/json
8.1.5. レスポンス
コード | メッセージ | データ型 |
---|---|---|
200 | 正常な応答。 |
|
0 | 予期しないエラーの応答。 |
8.1.6. サンプル
8.1.7. 共通のオブジェクト参照
8.1.7.1. CloudSourcesServiceUpdateCloudSourceBody
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
cloudSource | |||||
updateCredentials | Boolean | true の場合、cloud_source には有効な認証情報が含まれている必要があります。false の場合、リソースがすでに存在し、cloud_source の認証情報は無視されます。 |
8.1.7.2. CloudSourcesServiceUpdateCloudSourceBodyCloudSource
CloudSource は、検出されたクラスターのソースを提供するインテグレーションです。
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
name | String | ||||
type | TYPE_UNSPECIFIED, TYPE_PALADIN_CLOUD, TYPE_OCM, | ||||
credentials | |||||
skipTestIntegration | Boolean | ||||
paladinCloud | |||||
ocm |
8.1.7.3. GooglerpcStatus
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
code | Integer | int32 | |||
message | String | ||||
details | ProtobufAny のリスト |
8.1.7.4. ProtobufAny
Any
には、任意のシリアル化されたプロトコルバッファーメッセージと、シリアル化されたメッセージの型を記述する URL が含まれます。
Protobuf ライブラリーは、ユーティリティー関数または Any 型の追加の生成メソッドといった形式で Any 値をパック/アンパックするためのサポートを提供します。
例 1: C++ のメッセージをパックしてアンパックします。
Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... }
例 2: Java でメッセージをパックしてアンパックします。
Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) { foo = any.unpack(Foo.class); } // or ... if (any.isSameTypeAs(Foo.getDefaultInstance())) { foo = any.unpack(Foo.getDefaultInstance()); }
Example 3: Pack and unpack a message in Python.
foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.Unpack(foo) ...
Example 4: Pack and unpack a message in Go
foo := &pb.Foo{...} any, err := anypb.New(foo) if err != nil { ... } ... foo := &pb.Foo{} if err := any.UnmarshalTo(foo); err != nil { ... }
protobuf ライブラリーによって提供される pack メソッドは、デフォルトで型 URL として 'type.googleapis.com/full.type.name' を使用し、unpack メソッドは型 URL の最後の '/' の後の完全修飾型名のみを使用します。たとえば、"foo.bar.com/x/y.z" は型名 "y.z" を生成します。
8.1.7.4.1. JSON 表現
Any
値の JSON 表現では、逆シリアル化された埋め込みメッセージの通常の表現が使用され、型 URL を含む追加のフィールド @type
が含まれます。以下に例を示します。
package google.profile; message Person { string first_name = 1; string last_name = 2; }
{ "@type": "type.googleapis.com/google.profile.Person", "firstName": <string>, "lastName": <string> }
埋め込まれたメッセージ型が一般的であり、カスタム JSON 表現がある場合、その表現には、@type
フィールドに加えてカスタム JSON を保持するフィールドの 値
が追加されて埋め込まれます。例 ([google.protobuf.Duration][] メッセージの場合):
{ "@type": "type.googleapis.com/google.protobuf.Duration", "value": "1.212s" }
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
@type | String |
シリアル化されたプロトコルバッファーメッセージの型を一意に識別する URL/リソース名。この文字列には少なくとも \"/\" 文字が 1 つ以上含まれている必要があります。URL のパスの最後のセグメントは、型の完全修飾名を表す必要があります (例: |
8.1.7.5. V1CloudSourceCredentials
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
secret | String | 有効期間が長いトークンで単一値認証を行う場合に使用されます。 | |||
clientId | String | client_secret と組み合わせてクライアント認証に使用されます。 | |||
clientSecret | String | client_id と組み合わせてクライアント認証に使用されます。 |
8.1.7.6. V1CloudSourceType
列挙値 |
---|
TYPE_UNSPECIFIED |
TYPE_PALADIN_CLOUD |
TYPE_OCM |
8.1.7.7. V1OCMConfig
OCMConfig は、OpenShift cluster manager から検出されたクラスターを取得するために必要な情報を提供します。
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
endpoint | String |
8.1.7.8. V1PaladinCloudConfig
PaladinCloudConfig は、Paladin Cloud から検出されたクラスターを取得するために必要な情報を提供します。
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
endpoint | String |