Permissions

Metoda: dotModels.permissions.create

Utwórz uprawnienia dla określonego zasobu.

Punkt końcowy

post https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions
.

Parametry ścieżki

parent string

Wymagane. Zasób nadrzędny obiektu Permission. Formaty: tunedModels/{tunedModel} corpora/{corpus} Przyjmuje postać tunedModels/{tunedmodel}.

Treść żądania

Treść żądania zawiera wystąpienie elementu Permission.

Pola
granteeType enum (GranteeType)

Opcjonalnie: Stała. Rodzaj beneficjenta.

emailAddress string

Opcjonalnie: Stała. Adres e-mail użytkownika grupy, do którego odnosi się to uprawnienie. Pole nie jest ustawione, gdy typ użytkownika uprawnień to WSZYSCY.

role enum (Role)

Wymagane. Rola przypisana przez to uprawnienie.

Przykładowe żądanie

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

group_permission = model_info.permissions.create(
    role="READER",
    # Use "user" for an individual email address.
    grantee_type="group",
    email_address="genai-samples-test-group@googlegroups.com",
)

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Permission.

Metoda: builtModels.permissions.get

Pobiera informacje o określonym uprawnieniu.

Punkt końcowy

pobierz https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}
.

Parametry ścieżki

name string

Wymagane. Nazwa zasobu uprawnienia.

Formaty: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Przyjmuje postać tunedModels/{tunedmodel}/permissions/{permission}.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

public = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)
print(public)
name = public.name
print(name)  # tunedModels/{tunedModel}/permissions/{permission}

from_name = genai.types.Permissions.get(name)
print(from_name)

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Permission.

Metoda: tuneModels.permissions.list

Wyświetla listę uprawnień dotyczących określonego zasobu.

Punkt końcowy

pobierz https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions
.

Parametry ścieżki

parent string

Wymagane. Zasób nadrzędny uprawnień. Formaty: tunedModels/{tunedModel} corpora/{corpus} Przyjmuje postać tunedModels/{tunedmodel}.

Parametry zapytania

pageSize integer

Opcjonalnie: Maksymalna liczba zwracanych elementów Permission (na stronę). Usługa może zwrócić mniej uprawnień.

Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 10 uprawnień. Ta metoda zwraca maksymalnie 1000 uprawnień na stronę, nawet jeśli przekażesz większy rozmiar strony.

pageToken string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji permissions.list.

Podaj pageToken zwrócony przez jedno żądanie jako argument następnego żądania, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu permissions.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

for p in model_info.permissions.list():
    print(p)

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ListPermissionsResponse.

Metoda: tunelModels.permissions.patch

Aktualizuje uprawnienie.

Punkt końcowy

poprawka https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

Parametry ścieżki

permission.name string

Tylko dane wyjściowe. Identyfikator. Nazwa uprawnienia. Podczas tworzenia zostanie wygenerowana unikalna nazwa. Przykłady: tylko dostrojoneModele/{tunedModel}/permissions/{permission} korpus/{korpus}/permissions/{permission} – dane wyjściowe. Przyjmuje on postać tunedModels/{tunedmodel}/permissions/{permission}.

Parametry zapytania

updateMask string (FieldMask format)

Wymagane. Lista pól do zaktualizowania. Akceptowane: – rola (pole Permission.role)

Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "user.displayName,photo".

Treść żądania

Treść żądania zawiera wystąpienie elementu Permission.

Pola
role enum (Role)

Wymagane. Rola przypisana przez to uprawnienie.

Przykładowe żądanie

Python

        model_info = genai.get_model("tunedModels/my-increment-model")

        # ...

        test_group = model_info.permissions.create(
            role="writer",
            grantee_type="group",
            email_address="genai-samples-test-group@googlegroups.com",
        )

        test_group.update({"role": "READER"})

    def test_tuned_models_permission_delete(self):
        model_info = genai.get_model("tunedModels/my-increment-model")
        # ...

        public_permission = model_info.permissions.create(
            role="READER",
            grantee_type="EVERYONE",
        )

        public_permission.delete()


if __name__ == "__main__":
    absltest.main()

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Permission.

Metoda: tuneModels.permissions.delete

Usuwa uprawnienie.

Punkt końcowy

usuń https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}
.

Parametry ścieżki

name string

Wymagane. Nazwa zasobu uprawnienia. Formaty: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Przyjmuje postać tunedModels/{tunedmodel}/permissions/{permission}.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

public_permission.delete()

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Metoda: updatedModels.transferowner

Przenosi własność dostrojonego modelu. Jest to jedyny sposób na zmianę prawa własności do dostrojonego modelu. Obecny właściciel otrzyma rolę zapisującego.

Punkt końcowy

post https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership
.

Parametry ścieżki

name string

Wymagane. Nazwa zasobu dostrojonego modelu, którego własność zostanie przeniesiona.

Format: tunedModels/my-model-id Przyjmuje postać tunedModels/{tunedmodel}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Pola
emailAddress string

Wymagane. Adres e-mail użytkownika, na który ma zostać przeniesiony dostrojony model.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Zasób REST: personalizedModels.permissions

Zasób: Permission

Uprawnienie zapewnia użytkownikowi, grupie lub reszcie świata dostęp do zasobu interfejsu PaLM API (np. dostrojonego modelu czy korpusu).

Rola to zbiór dozwolonych operacji, który umożliwia użytkownikom wykonywanie określonych działań na zasobach interfejsu PaLM API. Aby je udostępnić użytkownikom, grupom lub kontom usługi, musisz przypisać do nich role. Przypisując rolę, przyznajesz jej uprawnienia.

Istnieją 3 role koncentryczne. Każda rola jest nadzbiorem dozwolonych operacji poprzedniej roli:

  • czytnik może używać zasobu (np. dostrojonego modelu, korpusu) w celu wnioskowania
  • autor ma uprawnienia czytelnika i dodatkowo może edytować i udostępniać
  • właściciel ma uprawnienia zapisującego i dodatkowo może usuwać
.
.
Pola
name string

Tylko dane wyjściowe. Identyfikator. Nazwa uprawnienia. Podczas tworzenia zostanie wygenerowana unikalna nazwa. Przykłady: tylko dostrojoneModele/{tunedModel}/permissions/{permission} korpus/{korpus}/permissions/{permission} – dane wyjściowe.

granteeType enum (GranteeType)

Opcjonalnie: Stała. Rodzaj beneficjenta.

emailAddress string

Opcjonalnie: Stała. Adres e-mail użytkownika grupy, do którego odnosi się to uprawnienie. Pole nie jest ustawione, gdy typ użytkownika uprawnień to WSZYSCY.

role enum (Role)

Wymagane. Rola przypisana przez to uprawnienie.

Zapis JSON
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

Odpowiedź z atrybutu ListPermissions zawierająca podzieloną na strony listę uprawnień.

.
Pola
permissions[] object (Permission)

Przywrócone uprawnienia.

nextPageToken string

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony.

Jeśli pominiesz to pole, nie będzie więcej stron.

Zapis JSON
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}