curl --request PATCH \
--url https://network.{region}.basaltic.sh/v1/subnets/{subnet_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "Public web-tier subnet",
"route_table": "a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f",
"tags": {},
"allocate_cidr_ipv6": false,
"cidr_ipv6": "2a13:9500:1a6:100::/64",
"copy_ipv4_security_rules": true,
"ipv6_routing": "match_ipv4"
}
'import requests
url = "https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}"
payload = {
"description": "Public web-tier subnet",
"route_table": "a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f",
"tags": {},
"allocate_cidr_ipv6": False,
"cidr_ipv6": "2a13:9500:1a6:100::/64",
"copy_ipv4_security_rules": True,
"ipv6_routing": "match_ipv4"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
description: 'Public web-tier subnet',
route_table: 'a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f',
tags: {},
allocate_cidr_ipv6: false,
cidr_ipv6: '2a13:9500:1a6:100::/64',
copy_ipv4_security_rules: true,
ipv6_routing: 'match_ipv4'
})
};
fetch('https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'description' => 'Public web-tier subnet',
'route_table' => 'a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f',
'tags' => [
],
'allocate_cidr_ipv6' => false,
'cidr_ipv6' => '2a13:9500:1a6:100::/64',
'copy_ipv4_security_rules' => true,
'ipv6_routing' => 'match_ipv4'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}"
payload := strings.NewReader("{\n \"description\": \"Public web-tier subnet\",\n \"route_table\": \"a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f\",\n \"tags\": {},\n \"allocate_cidr_ipv6\": false,\n \"cidr_ipv6\": \"2a13:9500:1a6:100::/64\",\n \"copy_ipv4_security_rules\": true,\n \"ipv6_routing\": \"match_ipv4\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"Public web-tier subnet\",\n \"route_table\": \"a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f\",\n \"tags\": {},\n \"allocate_cidr_ipv6\": false,\n \"cidr_ipv6\": \"2a13:9500:1a6:100::/64\",\n \"copy_ipv4_security_rules\": true,\n \"ipv6_routing\": \"match_ipv4\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"description\": \"Public web-tier subnet\",\n \"route_table\": \"a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f\",\n \"tags\": {},\n \"allocate_cidr_ipv6\": false,\n \"cidr_ipv6\": \"2a13:9500:1a6:100::/64\",\n \"copy_ipv4_security_rules\": true,\n \"ipv6_routing\": \"match_ipv4\"\n}"
response = http.request(request)
puts response.read_body{
"subnet": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "crn:network:sa-saopaulo-1:my-account:vpc/prod/subnet/prod-web",
"vpc": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "crn:network:sa-saopaulo-1:my-account:vpc/prod",
"name": "prod",
"cidr_ipv4": "10.0.0.0/16",
"tags": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "Production VPC for web and app tiers",
"cidr_ipv6": "2a13:9500:1a6:100::/60"
},
"route_table": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "crn:network:sa-saopaulo-1:my-account:vpc/prod/route-table/prod-private-rt",
"name": "prod-private-rt"
},
"name": "prod-web",
"cidr_ipv4": "10.0.1.0/24",
"gateway_ipv4": "10.0.1.1",
"tags": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "Public web-tier subnet",
"cidr_ipv6": "2a13:9500:1a6:100::/64",
"gateway_ipv6": "2a13:9500:1a6:100::1"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Actualizar la subred
Actualizar campos mutables (descripción, etiquetas). CIDR es inmutable.
curl --request PATCH \
--url https://network.{region}.basaltic.sh/v1/subnets/{subnet_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"description": "Public web-tier subnet",
"route_table": "a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f",
"tags": {},
"allocate_cidr_ipv6": false,
"cidr_ipv6": "2a13:9500:1a6:100::/64",
"copy_ipv4_security_rules": true,
"ipv6_routing": "match_ipv4"
}
'import requests
url = "https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}"
payload = {
"description": "Public web-tier subnet",
"route_table": "a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f",
"tags": {},
"allocate_cidr_ipv6": False,
"cidr_ipv6": "2a13:9500:1a6:100::/64",
"copy_ipv4_security_rules": True,
"ipv6_routing": "match_ipv4"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
description: 'Public web-tier subnet',
route_table: 'a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f',
tags: {},
allocate_cidr_ipv6: false,
cidr_ipv6: '2a13:9500:1a6:100::/64',
copy_ipv4_security_rules: true,
ipv6_routing: 'match_ipv4'
})
};
fetch('https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'description' => 'Public web-tier subnet',
'route_table' => 'a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f',
'tags' => [
],
'allocate_cidr_ipv6' => false,
'cidr_ipv6' => '2a13:9500:1a6:100::/64',
'copy_ipv4_security_rules' => true,
'ipv6_routing' => 'match_ipv4'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}"
payload := strings.NewReader("{\n \"description\": \"Public web-tier subnet\",\n \"route_table\": \"a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f\",\n \"tags\": {},\n \"allocate_cidr_ipv6\": false,\n \"cidr_ipv6\": \"2a13:9500:1a6:100::/64\",\n \"copy_ipv4_security_rules\": true,\n \"ipv6_routing\": \"match_ipv4\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"description\": \"Public web-tier subnet\",\n \"route_table\": \"a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f\",\n \"tags\": {},\n \"allocate_cidr_ipv6\": false,\n \"cidr_ipv6\": \"2a13:9500:1a6:100::/64\",\n \"copy_ipv4_security_rules\": true,\n \"ipv6_routing\": \"match_ipv4\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://network.{region}.basaltic.sh/v1/subnets/{subnet_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"description\": \"Public web-tier subnet\",\n \"route_table\": \"a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f\",\n \"tags\": {},\n \"allocate_cidr_ipv6\": false,\n \"cidr_ipv6\": \"2a13:9500:1a6:100::/64\",\n \"copy_ipv4_security_rules\": true,\n \"ipv6_routing\": \"match_ipv4\"\n}"
response = http.request(request)
puts response.read_body{
"subnet": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "crn:network:sa-saopaulo-1:my-account:vpc/prod/subnet/prod-web",
"vpc": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "crn:network:sa-saopaulo-1:my-account:vpc/prod",
"name": "prod",
"cidr_ipv4": "10.0.0.0/16",
"tags": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "Production VPC for web and app tiers",
"cidr_ipv6": "2a13:9500:1a6:100::/60"
},
"route_table": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crn": "crn:network:sa-saopaulo-1:my-account:vpc/prod/route-table/prod-private-rt",
"name": "prod-private-rt"
},
"name": "prod-web",
"cidr_ipv4": "10.0.1.0/24",
"gateway_ipv4": "10.0.1.1",
"tags": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "Public web-tier subnet",
"cidr_ipv6": "2a13:9500:1a6:100::/64",
"gateway_ipv6": "2a13:9500:1a6:100::1"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Resource not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}network:UpdateSubnet. Consulte permisos de redes para obtener la lista completa, lo que cubre cada una y un ejemplo de directiva.Autorizaciones
Un token bearer de OAuth 2.0, enviado como Authorization: Bearer <token>. Esta es la forma recomendada de autenticación.
Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en POST /v1/oauth/token con grant_type=client_credentials. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación.
Parámetros de ruta
ID de subred
Cuerpo
"Public web-tier subnet"
UUID de la tabla de rutas, CRN anidado o nombre exacto dentro de la subred VPC. En PATCH, la subred de ruta de acceso propietaria suministra la VPC. La omisión en create selecciona la tabla predeterminada; una referencia vacía no es válida.
"a3c9e1f4-7b2d-4a6e-8c1f-9d3b5e7a2c4f"
Show child attributes
Show child attributes
Asigne un /64 libre del rango IPv6 de la VPC. Puede ser habilitado después de la creación. Cada interfaz existente y nueva recibe un IPv6 /96 y su primer /128 automáticamente. Las puertas de enlace NAT alojadas aquí también reciben una dirección IPv6 pública del grupo regional. La actualización de las puertas de enlace alojadas requiere el permiso UpdateNATGateway y la cuota IPv6 pública.
Un /64 alineado dentro del rango IPv6 de la VPC. Se puede agregar más tarde; no puede reemplazar un rango existente. Mutuamente exclusivo con allocate_cidr_ipv6.
"2a13:9500:1a6:100::/64"
Al habilitar IPv6, copie las reglas equivalentes en los grupos de seguridad utilizados por las interfaces de esta subred. Copia 0.0.0.0/0 a ::/0 y referencias de grupo de seguridad, preservando el protocolo, puertos y dirección. Los CIDR IPv4 restringidos no se amplían. Los equivalentes IPv6 existentes no se duplican. Los cambios afectan a todas las interfaces que comparten estos grupos. Requiere el permiso CreateSecurityGroupRule y la cuota de reglas disponibles. Solo se acepta con allocate_cidr_ipv6 o cidr_ipv6.
Al habilitar IPv6, opcionalmente agregue ::/0 a la tabla de rutas de la subred. match_ipv4 sigue una ruta predeterminada de puerta de enlace de Internet IPv4 o puerta de enlace NAT, utilizando el mismo destino. Una puerta de enlace NAT debe tener IPv6 habilitado en su subred de alojamiento o estar hospedada en la subred que se está habilitando. Sin ruta predeterminada IPv4 deja el enrutamiento IPv6 sin cambios. Las rutas predeterminadas IPv6 existentes siempre se conservan. Las puertas de enlace de solo salida no pueden proporcionar acceso a Internet ULA; use una puerta de enlace NAT o una IP flotante IPv6 pública con una ruta de puerta de enlace de Internet. Los cambios afectan a todas las subredes que comparten la tabla de rutas y requieren el permiso CreateRoute; la creación de una puerta de enlace de solo salida también requiere el permiso CreateEgressOnlyGateway. Solo se acepta con allocate_cidr_ipv6 o cidr_ipv6.
match_ipv4, unchanged, internet_gateway, nat_gateway, egress_only_gateway Respuesta
Subnet actualizado
Show child attributes
Show child attributes