En esta página se explica cómo crear un recurso de configuración. Un recurso de configuración es un objeto de la API que almacena variables como pares clave-valor. Necesitas un recurso de configuración antes de que puedas configurar y obtener variables. Después de crear un recurso de configuración, puedes crear variables arbitrarias que puedes utilizar para almacenar datos.
Para obtener más información sobre las configuraciones, las variables y el servicio de Runtime Configurator, consulta Conceptos básicos de Runtime Configurator.
Antes de comenzar
- Si deseas usar los ejemplos de línea de comandos de esta guía, instala la herramienta de línea de comandos de gcloud.
- Si deseas usar los ejemplos de la API en esta guía, configura el acceso a la API.
- Lee Conceptos básicos de Runtime Configurator.
- Habilita la API de Runtime Configurator.
Crea una configuración
Puedes crear un recurso de configuración con Deployment Manager, la herramienta de línea de comandos gcloud o directamente con la API de Runtime Configurator.
Deployment Manager
Para crear una configuración en Deployment Manager, especifica el tipo de RuntimeConfig:
runtimeconfig.v1beta1.config
En el properties del recurso, proporciona la name y otras propiedades opcionales si lo deseas:
resources:
- name: [CONFIG_NAME]
type: runtimeconfig.v1beta1.config
properties:
config: [CONFIG_NAME]
description: [DESCRIPTION]
Donde:
[CONFIG_NAME]es el nombre para esta configuración.[DESCRIPTION]es la descripción de esta configuración (opcional).
gcloud
Con Google Cloud CLI, usa el
comando gcloud beta runtime-config configs create:
gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]
Donde:
[CONFIG_NAME]es el nombre para esta configuración.[DESCRIPTION]es la descripción de esta configuración (opcional).
gcloud muestra una respuesta como la siguiente:
Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para obtener una referencia completa de este comando gcloud, lee la documentación de referencia de runtime-config configs create.
API
En la API de REST, realiza una solicitud POST al siguiente URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/
En el ejemplo anterior, [PROJECT_ID] es el ID del proyecto para esta solicitud. La carga útil de la solicitud se ve de la siguiente manera:
{
"name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
"description": "[DESCRIPTION]"
}
Donde:
[PROJECT_ID]es el ID del proyecto de esta solicitud.[CONFIG_NAME]es el nombre de este RuntimeConfig.[DESCRIPTION]es la descripción de esta configuración (opcional).Para obtener más información sobre este método, lee la documentación
configs().create.
Borra un recurso RuntimeConfig
Cuando se borra un recurso RuntimeConfig, también se borran todos los recursos contenidos en ese recurso, esto incluye todas las variables y los recursos de espera.
Deployment Manager
Borra un recurso RuntimeConfig que forma parte de una implementación con el uso de uno de los siguientes métodos:
- Actualizar la implementación para omitir la configuración y volver a implementar la implementación
- Borrar la implementación y los recursos que contenga
gcloud
Con Google Cloud CLI, usa el comando
gcloud beta runtime-config configs delete:
gcloud beta runtime-config configs delete [CONFIG_NAME]
en el que [CONFIG_NAME] es el nombre del objeto de configuración.
Gcloud CLI muestra una respuesta como la siguiente:
Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].
Para obtener la referencia completa de gcloud, lee la documentación de referencia runtime-config configs delete.
API
En la API de REST, realiza una solicitud DELETE al siguiente URI:
https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]
Donde:
[PROJECT_ID]es el ID del proyecto de esta solicitud.[CONFIG_NAME]es el nombre de esta configuración.Para obtener más información sobre este método, lee la documentación
configs().delete.
¿Qué sigue?
- A continuación, crea algunas variables y aprende a configurar y obtener datos.
- Aprende a configurar un agente de observación en una variable específica.
- Crea un agente de observación que aparezca cuando una variable alcance una condición de cardinalidad.
- Consulta la referencia de v1beta1.
- Consulta las Cuotas para Runtime Configurator.
- Obtén más información sobre Runtime Configurator.