Spec-Zone.ru › Ansible

модуль google.cloud.gcp_vertexai_featurestore – создание ресурса GCP VertexAI.Featurestore

Примечание

Этот модуль входит в коллекцию google.cloud (версия 1.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: google.cloud.gcp_vertexai_featurestore.

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Коллекция объектов DataItem и аннотаций к ним.

Требования

На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.

  • python >= 3.8
  • requests >= 2.18.4
  • google-auth >= 2.25.1

Параметры

Параметр

Комментарии

access_token

string

Токен доступа, используемый для аутентификации.

auth_kind

string / обязательный

Тип используемых учетных данных.

Варианты:

  • "accesstoken"
  • "application"
  • "machineaccount"
  • "serviceaccount"

encryption_spec

dictionary

Если задано, это ключ будет использоваться для защиты хранилищ данных как в оперативном режиме, так и в автономном режиме.

kms_key_name

string / обязательный

Идентификатор ресурса Cloud KMS для управляемого клиентом ключа шифрования, используемого для защиты ресурса.

Имеет следующий формат: projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key.

Ключ должен находиться в том же регионе, где создается вычислительный ресурс.

env_type

string

Указывает среду Ansible, в которой выполняется этот модуль.

Не задавайте этот параметр, если не знаете, что делаете.

Он изменяет только строку User Agent для запросов к API.

force_destroy

boolean

Если задано значение true, все EntityTypes и Features этого Featurestore также будут удалены.

Варианты:

  • false ← (по умолчанию)
  • true

labels

dictionary

Набор пар «ключ/значение» меток, назначаемых этому Featurestore.

name

string / обязательный

Имя Featurestore.

Значение может содержать до 60 символов; допустимы символы [a-z0-9_].

Первым символом не может быть цифра.

online_serving_config

dictionary

Конфигурация ресурсов для обслуживания в оперативном режиме.

fixed_node_count

integer

Количество узлов в каждом кластере.

Количество узлов не будет масштабироваться автоматически, но его можно изменить вручную, указав другое значение при обновлении.

scaling

dictionary

Конфигурация масштабирования обслуживания в оперативном режиме.

Можно задать только один из параметров: fixedNodeCount или scaling.

При задании одного параметра другой сбрасывается.

max_node_count

integer / обязательный

Максимальное количество узлов, до которого можно увеличить число узлов.

Значение должно быть больше minNodeCount и не превышать десятикратное значение ‘minNodeCount’.

min_node_count

integer / обязательный

Минимальное количество узлов, до которого можно уменьшить их число.

Значение должно быть не меньше 1.

online_storage_ttl_days

integer

Срок хранения в днях (TTL) значений признаков в хранилище обслуживания в оперативном режиме.

Хранилище Feature Store в оперативном режиме периодически удаляет устаревшие значения признаков, срок хранения которых превышает onlineStorageTtlDays с момента создания признака.

Обратите внимание: для каждого EntityType в featurestore значение onlineStorageTtlDays должно быть меньше или равно offlineStorageTtlDays.

Если параметр не задан, по умолчанию используется 4000 дней.

По умолчанию: 4000

project

string

Проект Google Cloud Platform, который следует использовать.

region

string

Регион набора данных.

Например, us-central1.

scopes

list / элементы=string

Массив используемых областей доступа.

service_account_contents

jsonarg

Содержимое JSON-файла учетной записи службы

в виде словаря или JSON-строки, представляющей его.

service_account_email

string

Необязательный адрес электронной почты учетной записи службы, если выбрана

учетная запись машины и пользователь не хочет использовать адрес по умолчанию.

service_account_file

path

Путь к JSON-файлу учетной записи службы, если в качестве типа

выбрана учетная запись службы.

state

string

Должен ли ресурс существовать в GCP.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

Примечания

Примечание

  • Справочник API: https://cloud.google.com/vertex-ai/docs/reference/rest/v1/projects.locations.featurestores
  • Официальное руководство по документации: https://cloud.google.com/vertex-ai/docs
  • Для аутентификации можно задать auth_kind с помощью переменной среды GCP_AUTH_KIND.
  • Для аутентификации можно задать service_account_file с помощью переменной среды GCP_SERVICE_ACCOUNT_FILE.
  • Для аутентификации можно задать service_account_contents с помощью переменной среды GCP_SERVICE_ACCOUNT_CONTENTS.
  • Для аутентификации можно задать service_account_email с помощью переменной среды GCP_SERVICE_ACCOUNT_EMAIL.
  • Для аутентификации можно задать access_token с помощью переменной среды GCP_ACCESS_TOKEN.
  • Для аутентификации можно задать scopes с помощью переменной среды GCP_SCOPES.
  • Значения переменных среды используются только в том случае, если значения в плейбуке не заданы.
  • Параметры service_account_email, service_account_file, service_account_file и access_token взаимоисключающие.

Примеры

- name: Create Featurestore
  google.cloud.gcp_vertexai_featurestore:
    state: present
    name: "{{ resource_name }}"
    region: us-central1
    online_serving_config:
      fixed_node_count: 2
    project: "{{ gcp_project }}"
    auth_kind: "{{ gcp_cred_kind }}"
    service_account_file: "{{ gcp_cred_file }}"
  register: _myfs

- name: Delete Featurestore
  google.cloud.gcp_vertexai_featurestore:
    state: absent
    name: "{{ _myfs.name }}"
    region: us-central1
    project: "{{ gcp_project }}"
    auth_kind: "{{ gcp_cred_kind }}"
    service_account_file: "{{ gcp_cred_file }}"

################################################################################

- name: Create Featurestore with scaling configuration
  google.cloud.gcp_vertexai_featurestore:
    state: present
    name: "{{ resource_name }}"
    region: us-central1
    online_serving_config:
      scaling:
        min_node_count: 1
        max_node_count: 10
    project: "{{ gcp_project }}"
    auth_kind: "{{ gcp_cred_kind }}"
    service_account_file: "{{ gcp_cred_file }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ

Описание

changed

boolean

Был ли изменен ресурс.

Возвращается: всегда

createTime

string

Время создания featurestore в формате RFC3339 UTC «Zulu», с наносекундной точностью и до девяти знаков после запятой.

Возвращается: при успешном выполнении

etag

string

Используется для согласованного выполнения операций чтения, изменения и записи.

Возвращается: при успешном выполнении

state

string

Текущее состояние ресурса.

Возвращается: всегда

updateTime

string

Время последнего обновления featurestore в формате RFC3339 UTC «Zulu», с наносекундной точностью и до девяти знаков после запятой.

Возвращается: при успешном выполнении

Авторы

  • Google Inc. (@googlecloudplatform)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/google/cloud/gcp_vertexai_featurestore_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API