Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • ИИ для бизнеса
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Identity Hub
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Аутентификация
      • Overview
        • Overview
          • Overview
            • Overview
            • Get
            • List
            • Create
            • Update
            • Suspend
            • Reactivate
            • Delete
            • ListOperations
            • ListAccessBindings
            • SetAccessBindings
            • UpdateAccessBindings
            • ListAssignments
            • UpdateAssignments
  • Аудитные логи Audit Trails
  • История изменений
  • Обучающие курсы

В этой статье:

  • HTTP request
  • Path parameters
  • Response
  • SuspendApplicationMetadata
  • Status
  • Application
  • GroupClaimsSettings
  • ClientGrant
  1. Справочник API
  2. REST (англ.)
  3. Identity Provider API
  4. OAUTH Application API
  5. Application
  6. Suspend

OAUTH Application API, REST: Application.Suspend

Статья создана
Yandex Cloud
Обновлена 3 октября 2025 г.
  • HTTP request
  • Path parameters
  • Response
  • SuspendApplicationMetadata
  • Status
  • Application
  • GroupClaimsSettings
  • ClientGrant

Sets status to SUSPENDED for the specified OAuth application.

HTTP requestHTTP request

POST https://organization-manager.api.cloud.yandex.net/organization-manager/v1/idp/application/oauth/applications/{applicationId}:suspend

Path parametersPath parameters

Request to suspend a OAuth application.

Field

Description

applicationId

string

Required field. ID of the OAuth application to suspend.
To get the OAuth application ID, make a ApplicationService.List request.

ResponseResponse

HTTP Code: 200 - OK

{
  "id": "string",
  "description": "string",
  "createdAt": "string",
  "createdBy": "string",
  "modifiedAt": "string",
  "done": "boolean",
  "metadata": {
    "applicationId": "string"
  },
  // Includes only one of the fields `error`, `response`
  "error": {
    "code": "integer",
    "message": "string",
    "details": [
      "object"
    ]
  },
  "response": {
    "id": "string",
    "name": "string",
    "organizationId": "string",
    "description": "string",
    "groupClaimsSettings": {
      "groupDistributionType": "string"
    },
    "clientGrant": {
      "clientId": "string",
      "authorizedScopes": [
        "string"
      ]
    },
    "status": "string",
    "labels": "object",
    "createdAt": "string",
    "updatedAt": "string"
  }
  // end of the list of possible fields
}

An Operation resource. For more information, see Operation.

Field

Description

id

string

ID of the operation.

description

string

Description of the operation. 0-256 characters long.

createdAt

string (date-time)

Creation timestamp.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

createdBy

string

ID of the user or service account who initiated the operation.

modifiedAt

string (date-time)

The time when the Operation resource was last modified.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

done

boolean

If the value is false, it means the operation is still in progress.
If true, the operation is completed, and either error or response is available.

metadata

SuspendApplicationMetadata

Service-specific metadata associated with the operation.
It typically contains the ID of the target resource that the operation is performed on.
Any method that returns a long-running operation should document the metadata type, if any.

error

Status

The error result of the operation in case of failure or cancellation.

Includes only one of the fields error, response.

The operation result.
If done == false and there was no failure detected, neither error nor response is set.
If done == false and there was a failure detected, error is set.
If done == true, exactly one of error or response is set.

response

Application

The normal response of the operation in case of success.
If the original method returns no data on success, such as Delete,
the response is google.protobuf.Empty.
If the original method is the standard Create/Update,
the response should be the target resource of the operation.
Any method that returns a long-running operation should document the response type, if any.

Includes only one of the fields error, response.

The operation result.
If done == false and there was no failure detected, neither error nor response is set.
If done == false and there was a failure detected, error is set.
If done == true, exactly one of error or response is set.

SuspendApplicationMetadataSuspendApplicationMetadata

Metadata for the ApplicationService.Suspend operation.

Field

Description

applicationId

string

ID of the OAuth application that is being suspended.

StatusStatus

The error result of the operation in case of failure or cancellation.

Field

Description

code

integer (int32)

Error code. An enum value of google.rpc.Code.

message

string

An error message.

details[]

object

A list of messages that carry the error details.

ApplicationApplication

An OAuth application resource.

Field

Description

id

string

ID of the application.

name

string

Name of the application.
The name is unique within the organization. 3-63 characters long.

organizationId

string

ID of the organization that the application belongs to.

description

string

Description of the application. 0-256 characters long.

groupClaimsSettings

GroupClaimsSettings

Settings of the group claims

clientGrant

ClientGrant

Represents current connection to the OAuth client with specified scopes

status

enum (Status)

Current status of the application.

  • STATUS_UNSPECIFIED: The status is not specified.
  • CREATING: The apllication is in the process of being created.
  • ACTIVE: The apllication is active and operational.
  • SUSPENDED: The apllication is suspended. I.e. authentication via this application is disabled.
  • DELETING: The apllication is in the process of being deleted.

labels

object (map<string, string>)

Resource labels as key:value pairs.

createdAt

string (date-time)

Creation timestamp.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

updatedAt

string (date-time)

Modification timestamp.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

GroupClaimsSettingsGroupClaimsSettings

Settings of the group claims

Field

Description

groupDistributionType

enum (GroupDistributionType)

Represents current distribution type of the groups. I.e. which groups are visible for the application users.

  • GROUP_DISTRIBUTION_TYPE_UNSPECIFIED: The distribution type is unspecified
  • NONE: No groups are visible for the application users
  • ASSIGNED_GROUPS: Only assigned groups are visible for the application users
  • ALL_GROUPS: All groups are visible for the application users

ClientGrantClientGrant

Represents connection to the OAuth client with specified scopes

Field

Description

clientId

string

Required field. OAuth client id

authorizedScopes[]

string

List of authorized client scopes by the application

Была ли статья полезна?

Предыдущая
Update
Следующая
Reactivate
Проект Яндекса
© 2025 ООО «Яндекс.Облако»