Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第52章 RoleService

52.1. ComputeEffectiveAccessScope
リンクのコピー

POST /v1/computeeffectiveaccessscope

ComputeEffectiveAccessScope

52.1.1. 説明
リンクのコピー

リクエストのルールに基づいて有効なアクセススコープを返します。何も永続化しません。クラスターおよび namespace の変更によりべき等ではありません。POST は、潜在的に大きなペイロードが原因で選択されます。レスポンススリムを維持することと詳細な利点があります。選択したクラスターおよび名前空間の ID のみが含まれる場合、応答時間と処理時間は短くなりますが、呼び出し元は一貫性の問題の影響を受けやすい世界のビューと応答をオーバーレイすることになります。関連するメタデータを持つすべてのクラスターと namespace を一覧表示することは、呼び出し元には便利ですが、セカンダリーデータを含むメッセージを借用します。呼び出し元は、含まれるサブツリーのルートのみが ID でリストされている場合に、持つ詳細レベルを決定することができます。- 含まれるサブツリーのルートのみが ID でリストされている場合。クラスターは、INCLUDED （名前空間が含まれていますがリストされていません）または PARTIAL （少なくとも 1 つの名前空間が明示的に含まれます）のいずれかにすることができます。namespace は INCLUDED にすることができます。- 標準 [default] は、すべての既知のクラスターと namespace がそれらの ID と名前とともに一覧表示されている場合のみです。クラスターは、INCLUDED （すべての名前空間が明示的に INCLUDED としてリストされる）、PARTIAL （すべての名前空間は明示的に一覧表示され、INCLUDED などがあります）、および EXCLUDED （すべての名前空間は EXCLUDED として明示的に一覧表示されます）。namespace は、すべてのクラスターおよび namespace がメタデータで拡張される際に、INCLUDED または EXCLUDED のいずれかになります。

52.1.2. パラメーター
リンクのコピー

52.1.2.1. ボディパラメーター
リンクのコピー

Expand
名前説明必須デフォルトPattern

body

ComputeEffectiveAccessScopeRequestPayload

X

  

52.1.2.2. クエリーパラメーター
リンクのコピー

Expand
名前説明必須デフォルトPattern

detail

 

-

STANDARD （標準）

 

52.1.3. 戻り値のタイプ
リンクのコピー

StorageEffectiveAccessScope

52.1.4. コンテンツタイプ
リンクのコピー

  • application/json

52.1.5. レスポンス
リンクのコピー

Expand
表52.1 HTTP 応答コード
コードメッセージデータタイプ

200

正常な応答。

StorageEffectiveAccessScope

0

予期しないエラーの応答です。

RuntimeError

52.1.6. サンプル
リンクのコピー

52.1.7. 共通のオブジェクト参照
リンクのコピー

52.1.7.1. ComputeEffectiveAccessScopeRequestPayload
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

simpleRules

  

SimpleAccessScopeRules

  

52.1.7.2. ProtobufAny
リンクのコピー

any には、シリアライズされたメッセージの型を記述する URL とともに、任意のシリアライズされたプロトコルバッファーメッセージが含まれます。

Protobuf ライブラリーは、パック/アンパックをサポートします。任意の値は、ユーティリティー関数の形式で、または Any タイプの追加の生成されたメソッドになります。

例 1: C++ のメッセージをパックして展開します。 

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}
Copy to Clipboard Toggle word wrap

例 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());
}
Copy to Clipboard Toggle word wrap 
Example 3: Pack and unpack a message in Python.
Copy to Clipboard Toggle word wrap 
foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...
Copy to Clipboard Toggle word wrap 
Example 4: Pack and unpack a message in Go
Copy to Clipboard Toggle word wrap 
foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}
Copy to Clipboard Toggle word wrap

protobuf ライブラリーが提供するパックメソッドは、デフォルトで type.googleapis.com/full.type.name をタイプ URL として使用し、unzip メソッドは、タイプ URL の最後の//のみを使用します。たとえば、"foo.bar.com/x/y.z" のように、"foo.bar.com/x/y.z" の型名 "y.z" が生成されます。

52.1.7.2.1. JSON 表現
リンクのコピー

Any 値の JSON 表現は、デシリアライズされた埋め込みメッセージの通常の表現を使用し、タイプ URL が含まれる追加のフィールド @type を使用します。以下に例を示します。 

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}
Copy to Clipboard Toggle word wrap 
{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}
Copy to Clipboard Toggle word wrap

埋め込みメッセージタイプがよく知られていて、カスタム JSON 表現がある場合、その表現は埋め込みされ、@type フィールドに加えてカスタム JSON を保持するフィールド 値 が追加されます。例（メッセージ [google.protobuf.Duration][] の場合）: 

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}
Copy to Clipboard Toggle word wrap
Expand
フィールド名必須Null 許容型型説明形式

typeUrl

  

String

シリアライズされたプロトコルバッファーメッセージのタイプを一意に識別する URL/リソース名。この文字列には最低でも 1 つの \"/\" 文字を含める必要があります。URL のパスの最後のセグメントは、タイプの完全修飾名( path/google.protobuf.Durationにあるように)を表す必要があります。名前は正規の形式である必要があります（たとえば、先頭 \".\" は受け入れられません）。実際には、チームは通常、バイナリーにプリコンパイルして、任意 のコンテキストで使用することを期待しているすべてのタイプにプレコンパイルします。ただし、スキーム http、https、またはスキームを使用しない URL の場合、以下のようにタイプ URL をメッセージ定義にマップするタイプサーバーを設定できます。* スキームが指定されていない場合、https は想定されます。* URL の HTTP GET はバイナリー形式の [google.protobuf.Type][] 値を生成するか、エラーを生成する必要があります。* アプリケーションは、URL に基づいてルックアップ結果をキャッシュするか、ルックアップを回避するためにバイナリーにプリコンパイルして使用できます。したがって、タイプへの変更時にバイナリー互換性を保持する必要があります。（バージョン付けされたタイプ名を使用して、重大な変更を管理します。）注記：この機能は現在、公式の protobuf リリースでは利用できないため、type.googleapis.com で始まるタイプ URL には使用されません。2023 年 5 月時点では、広く使用されているタイプサーバー実装はもう 1 つも実装する予定はありません。http 以外のスキーム、https （または空のスキーム）は、実装固有のセマンティクスで使用できます。

 

value

  

byte[]

上記の指定されたタイプの有効なシリアライズされたプロトコルバッファーである必要があります。

byte

52.1.7.3. RuntimeError
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

error

  

String

  

code

  

Integer

 

int32

message

  

String

  

details

  

ProtobufAnyのリスト

  

52.1.7.4. SimpleAccessScopeRules
リンクのコピー

繰り返されるフィールドの各要素は、個別のルールです。ルールは論理 OR で結合されます。リソース x を許可するルールが存在する場合は、x がアクセススコープにあります。

Expand
フィールド名必須Null 許容型型説明形式

includedClusters

  

string のリスト

  

includedNamespaces

  

SimpleAccessScopeRulesNamespaceの一覧

  

clusterLabelSelectors

  

StorageSetBasedLabelSelectorの一覧

  

namespaceLabelSelectors

  

StorageSetBasedLabelSelectorの一覧

  

52.1.7.5. SimpleAccessScopeRulesNamespace
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

clusterName

  

String

両方のフィールドを設定する必要があります。

 

namespaceName

  

String

  

52.1.7.6. StorageEffectiveAccessScope
リンクのコピー

EffectiveAccessScope は、どのクラスターおよび名前空間が現在の状態にあるかを説明します。基本的に、AccessScope が現在知られているクラスターと namespace に適用されている場合、結果は EffectiveAccessScope になります。

EffectiveAccessScope は、包含済みおよび除外されたノードを持つツリーを表します。ノードが含まれている場合は、そのすべての子ノードが含まれます。

Expand
フィールド名必須Null 許容型型説明形式

clusters

  

List of StorageEffectiveAccessScopeCluster

  

52.1.7.7. StorageEffectiveAccessScopeCluster
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

id

  

String

  

name

  

String

  

state

  

StorageEffectiveAccessScopeState

 

UNKNOWN、INCLUDED、EXCLUDED、PARTIAL

labels

  

文字列のマップ

  

namespaces

  

List of StorageEffectiveAccessScopeNamespace

  

52.1.7.8. StorageEffectiveAccessScopeNamespace
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

id

  

String

  

name

  

String

  

state

  

StorageEffectiveAccessScopeState

 

UNKNOWN、INCLUDED、EXCLUDED、PARTIAL

labels

  

文字列のマップ

  

52.1.7.9. StorageEffectiveAccessScopeState
リンクのコピー

Expand
Enum 値

UNKNOWN

INCLUDED

EXCLUDED

PARTIAL

52.1.7.10. StorageSetBasedLabelSelector
リンクのコピー

SetBasedLabelSelector は、セットベースのラベル要件のみを許可します。

次に利用可能なタグ：3

Expand
フィールド名必須Null 許容型型説明形式

要件

  

List of StorageSetBasedLabelSelectorRequirement

  

52.1.7.11. StorageSetBasedLabelSelectorOperator
リンクのコピー

Expand
Enum 値

UNKNOWN

IN

NOT_IN

EXISTS

NOT_EXISTS

52.1.7.12. StorageSetBasedLabelSelectorRequirement
リンクのコピー

Next available tag: 4
Copy to Clipboard Toggle word wrap
Expand
フィールド名必須Null 許容型型説明形式

key

  

String

  

op

  

StorageSetBasedLabelSelectorOperator

 

UNKNOWN、IN、NOT_IN、EXISTS、NOT_EXISTS、

values

  

string のリスト

  
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat