第23章 DiscoveredClustersService
23.1. CountDiscoveredClusters リンクのコピーリンクがクリップボードにコピーされました!
GET /v1/count/discovered-clusters
CountDiscoveredClusters は、要求されたフィールドでフィルタリングした後、検出されたクラスターの数を返します。
23.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
23.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
23.1.2.1. クエリーパラメーター リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | 必須 | デフォルト | Pattern |
---|---|---|---|---|
filter.names |
特定の名前の検出されたクラスターを照合します。 | - | null | |
filter.types |
特定のタイプの検出クラスターを照合します。 | - | null | |
filter.statuses |
検出された特定のステータスクラスターの一致。- STATUS_UNSPECIFIED: クラスターのステータスが不明です。セキュアなクラスターが一致する可能性のあるメタデータが欠落している場合がありました。STATUS_SECURED: 検出されたクラスターはセキュアなクラスターと一致していました。- STATUS_UNSECURED: 検出されたクラスターはセキュアなクラスターと一致していません。 | - | null | |
filter.sourceIds |
特定のクラウドソース ID の検出クラスターを照合します。 | - | null |
23.1.3. 戻り値のタイプ リンクのコピーリンクがクリップボードにコピーされました!
23.1.4. コンテンツタイプ リンクのコピーリンクがクリップボードにコピーされました!
- application/json
23.1.5. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
コード | メッセージ | データタイプ |
---|---|---|
200 | 正常な応答。 | |
0 | 予期しないエラーの応答です。 |
23.1.6. サンプル リンクのコピーリンクがクリップボードにコピーされました!
23.1.7. 共通のオブジェクト参照 リンクのコピーリンクがクリップボードにコピーされました!
23.1.7.1. ProtobufAny リンクのコピーリンクがクリップボードにコピーされました!
any
には、シリアライズされたメッセージの型を記述する URL とともに、任意のシリアライズされたプロトコルバッファーメッセージが含まれます。
Protobuf ライブラリーは、パック/アンパックをサポートします。任意の値は、ユーティリティー関数の形式で、または Any タイプの追加の生成されたメソッドになります。
例 1: C++ のメッセージをパックして展開します。
例 2: Java でメッセージをパックして解凍します。
Example 3: Pack and unpack a message in Python.
Example 3: Pack and unpack a message in Python.
Example 4: Pack and unpack a message in Go
Example 4: Pack and unpack a message in Go
protobuf ライブラリーが提供するパックメソッドは、デフォルトで type.googleapis.com/full.type.name をタイプ URL として使用し、unzip メソッドは、タイプ URL の最後の//のみを使用します。たとえば、"foo.bar.com/x/y.z" のように、"foo.bar.com/x/y.z" の型名 "y.z" が生成されます。
23.1.7.1.1. JSON 表現 リンクのコピーリンクがクリップボードにコピーされました!
Any
値の JSON 表現は、デシリアライズされた埋め込みメッセージの通常の表現を使用し、タイプ URL が含まれる追加のフィールド @type
を使用します。以下に例を示します。
package google.profile; message Person { string first_name = 1; string last_name = 2; }
package google.profile;
message Person {
string first_name = 1;
string last_name = 2;
}
{ "@type": "type.googleapis.com/google.profile.Person", "firstName": <string>, "lastName": <string> }
{
"@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" }
{
"@type": "type.googleapis.com/google.protobuf.Duration",
"value": "1.212s"
}
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
typeUrl | String |
シリアライズされたプロトコルバッファーメッセージのタイプを一意に識別する URL/リソース名。この文字列には最低でも 1 つの \"/\" 文字を含める必要があります。URL のパスの最後のセグメントは、タイプの完全修飾名( | |||
value | byte[] | 上記の指定されたタイプの有効なシリアライズされたプロトコルバッファーである必要があります。 | byte |
23.1.7.2. RuntimeError リンクのコピーリンクがクリップボードにコピーされました!
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
error | String | ||||
code | Integer | int32 | |||
message | String | ||||
details | ProtobufAnyのリスト |
23.1.7.3. V1CountDiscoveredClustersResponse リンクのコピーリンクがクリップボードにコピーされました!
フィールド名 | 必須 | Null 許容型 | 型 | 説明 | 形式 |
---|---|---|---|---|---|
count | Integer | int32 |