メソッド: tuningModels.permissions.create
- エンドポイント
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- リクエストの例
<ph type="x-smartling-placeholder">
- </ph>
- 作成(チューニング済みモデル)
特定のリソースに対する権限を作成する。
エンドポイント
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 投稿
https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions
パスパラメータ
parent
string
必須。Permission
の親リソース。形式: tunedModels/{tunedModel}
corpora/{corpus}
tunedModels/{tunedmodel}
の形式になります。
リクエスト本文
リクエストの本文には Permission
のインスタンスが含まれます。
granteeType
enum (GranteeType
)
省略可。変更不可。譲受人のタイプ。
emailAddress
string
省略可。変更不可。この権限が参照するグループのユーザーのメールアドレス。権限の付与対象タイプが「EVERYONE」の場合、フィールドは設定されません。
role
enum (Role
)
必須。この権限によって付与されるロール。
リクエスト例
Python
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Permission
のインスタンスが含まれます。
メソッド: tuningModels.permissions.get
- エンドポイント
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- リクエストの例
<ph type="x-smartling-placeholder">
- </ph>
- Get(チューニング済みモデル)
特定の権限に関する情報を取得します。
エンドポイント
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 入手
https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}
パスパラメータ
name
string
必須。権限のリソース名。
形式: tunedModels/{tunedModel}/permissions/{permission}
corpora/{corpus}/permissions/{permission}
tunedModels/{tunedmodel}/permissions/{permission}
の形式になります。
リクエスト本文
リクエストの本文は空にする必要があります。
リクエスト例
Python
レスポンスの本文
成功した場合、レスポンスの本文には Permission
のインスタンスが含まれます。
メソッド: tuningModels.permissions.list
- エンドポイント
- パスパラメータ
- クエリ パラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- リクエストの例
<ph type="x-smartling-placeholder">
- </ph>
- List(チューニング済みモデル)
特定のリソースの権限を一覧表示します。
エンドポイント
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 入手
https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions
パスパラメータ
parent
string
必須。権限の親リソース。形式: tunedModels/{tunedModel}
corpora/{corpus}
tunedModels/{tunedmodel}
の形式になります。
クエリ パラメータ
pageSize
integer
省略可。返される Permission
の最大数(1 ページあたり)。サービスから返される権限が少なくなる場合があります。
指定しない場合、最大で 10 個の権限が返されます。このメソッドでは、より大きい pageSize を渡しても、1 ページあたり最大 1, 000 個の権限が返されます。
pageToken
string
省略可。前回の permissions.list
呼び出しから受け取ったページトークン。
次のページを取得するには、あるリクエストで返された pageToken
を次のリクエストの引数として指定します。
ページ分割を行う場合、permissions.list
に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。
リクエストの本文
リクエストの本文は空にする必要があります。
リクエスト例
Python
レスポンスの本文
成功した場合、レスポンスの本文には ListPermissionsResponse
のインスタンスが含まれます。
メソッド: tuningModels.permissions.patch
- エンドポイント
- パスパラメータ
- クエリ パラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- リクエストの例
<ph type="x-smartling-placeholder">
- </ph>
- 更新(チューニング済みモデル)
権限を更新します。
エンドポイント
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> パッチ
https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}
PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}
パスパラメータ
permission.name
string
出力専用。ID。権限名。作成時に一意の名前が生成されます。例: tuningModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission}。出力のみ。形式は tunedModels/{tunedmodel}/permissions/{permission}
です。
クエリ パラメータ
updateMask
string (FieldMask
format)
必須。更新するフィールドのリスト。使用できるもの: - ロール(Permission.role
フィールド)
完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"
。
リクエストの本文
リクエストの本文には Permission
のインスタンスが含まれます。
role
enum (Role
)
必須。この権限によって付与されるロール。
リクエスト例
Python
レスポンスの本文
成功した場合、レスポンスの本文には Permission
のインスタンスが含まれます。
メソッド: tuningModels.permissions.delete
- エンドポイント
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- リクエストの例
<ph type="x-smartling-placeholder">
- </ph>
- Delete(チューニング済みモデル)
権限を削除します。
エンドポイント
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 削除
https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}
パスパラメータ
name
string
必須。権限のリソース名。形式: tunedModels/{tunedModel}/permissions/{permission}
corpora/{corpus}/permissions/{permission}
tunedModels/{tunedmodel}/permissions/{permission}
の形式になります。
リクエスト本文
リクエストの本文は空にする必要があります。
リクエスト例
Python
レスポンスの本文
成功すると、レスポンスの本文は空になります。
メソッド: tuningModels.transferOwnership
チューニング済みモデルの所有権を譲渡します。これは、チューニング済みモデルの所有権を変更する唯一の方法です。現在のオーナーは書き込みロールにダウングレードされます。
エンドポイント
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 投稿
https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership
パスパラメータ
name
string
必須。所有権を移行するチューニング済みモデルのリソース名。
形式: tunedModels/my-model-id
。tunedModels/{tunedmodel}
の形式になります。
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
<ph type="x-smartling-placeholder">emailAddress
string
必須。チューニング済みモデルの転送先ユーザーのメールアドレス。
レスポンスの本文
成功すると、レスポンスの本文は空になります。
REST リソース: tuningModels.permissions
- リソース: Permission
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- メソッド
リソース: Permission
権限リソースは、ユーザー、グループ、その他のユーザーに PaLM API リソース(チューニング済みモデル、コーパスなど)へのアクセス権を付与します。
ロールとは、ユーザーが PaLM API リソースに対して特定の操作を実行できるようにする、許可された操作の集まりです。ユーザー、グループ、サービス アカウントで使用できるようにするには、ロールを割り当てます。ロールを割り当てると、そのロールに含まれる権限が付与されます。
同心円状のロールが 3 つあります。各ロールは、前のロールで許可されているオペレーションのスーパーセットです。
- リーダーはリソース(チューニング済みモデル、コーパスなど)を推論に使用できる
- 作成者は閲覧者の権限を持ち、さらに編集と共有を行うことができます
- オーナーはライターの権限を持ち、さらにオーナーは
name
string
出力専用。ID。権限名。作成時に一意の名前が生成されます。例: tuningModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission}。出力のみ。
granteeType
enum (GranteeType
)
省略可。変更不可。譲受人のタイプ。
emailAddress
string
省略可。変更不可。この権限が参照するグループのユーザーのメールアドレス。権限の付与対象タイプが「EVERYONE」の場合、フィールドは設定されません。
role
enum (Role
)
必須。この権限によって付与されるロール。
JSON 表現 |
---|
{ "name": string, "granteeType": enum ( |
ListPermissionsResponse
権限のページ分けされたリストを含む ListPermissions
からのレスポンス。
permissions[]
object (Permission
)
返される権限。
nextPageToken
string
次のページを取得するために pageToken
として送信できるトークン。
このフィールドを省略すると、ページがなくなります。
JSON 表現 |
---|
{
"permissions": [
{
object ( |