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 que [PROJECT_ID]
es el ID del proyecto para esta solicitud. La carga útil para 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 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 similar a 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.