odb_networks
Creates, updates, deletes, gets or lists an odb_networks resource.
Overview
| Name | odb_networks |
| Type | Resource |
| Id | aws.odb.odb_networks |
Fields
The following fields are returned by SELECT queries:
- get_odb_network
- list_odb_networks
| Name | Datatype | Description |
|---|---|---|
availability_zone | string | The Amazon Web Services Availability Zone (AZ) where the ODB network is located. |
availability_zone_id | string | The AZ ID of the AZ where the ODB network is located. |
backup_subnet_cidr | string | The CIDR range of the backup subnet in the ODB network. |
client_subnet_cidr | string | The CIDR range of the client subnet in the ODB network. |
created_at | string (date-time) | The date and time when the ODB network was created. |
custom_domain_name | string | The domain name for the resources in the ODB network. |
default_dns_prefix | string | The DNS prefix to the default DNS domain name. The default DNS domain name is oraclevcn.com. |
display_name | string | The user-friendly name of the ODB network. |
ec_2_placement_group_ids | array | The list of EC2 Placement Group IDs associated with your ODB network. |
managed_services | object | The managed services configuration for the ODB network. |
oci_dns_forwarding_configs | array | The DNS resolver endpoint in OCI for forwarding DNS queries for the ociPrivateZone domain. |
oci_network_anchor_id | string | The unique identifier of the OCI network anchor for the ODB network. |
oci_network_anchor_url | string | The URL of the OCI network anchor for the ODB network. |
oci_resource_anchor_name | string | The name of the OCI resource anchor that's associated with the ODB network. |
oci_vcn_id | string | The Oracle Cloud ID (OCID) for the Virtual Cloud Network (VCN) that's associated with the ODB network. |
oci_vcn_url | string | The URL for the VCN that's associated with the ODB network. |
odb_network_arn | string | The Amazon Resource Name (ARN) of the ODB network. |
odb_network_id | string | The unique identifier of the ODB network. (pattern: <code>(arn:(?:aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):[a-z0-9-]+:[a-z0-9-]*:[0-9]+:[a-z0-9-]+/[a-zA-Z0-9_ |
peered_cidrs | array | The list of CIDR ranges from the peered VPC that are allowed access to the ODB network. |
percent_progress | number (float) | The amount of progress made on the current operation on the ODB network, expressed as a percentage. |
status | string | The current status of the ODB network. (AVAILABLE, FAILED, PROVISIONING, TERMINATED, TERMINATING, UPDATING, MAINTENANCE_IN_PROGRESS) |
status_reason | string | Additional information about the current status of the ODB network. |
| Name | Datatype | Description |
|---|---|---|
availability_zone | string | The Amazon Web Services Availability Zone (AZ) where the ODB network is located. |
availability_zone_id | string | The AZ ID of the AZ where the ODB network is located. |
backup_subnet_cidr | string | The CIDR range of the backup subnet in the ODB network. |
client_subnet_cidr | string | The CIDR range of the client subnet in the ODB network. |
created_at | string (date-time) | The date and time when the ODB network was created. |
custom_domain_name | string | The domain name for the resources in the ODB network. |
default_dns_prefix | string | The DNS prefix to the default DNS domain name. The default DNS domain name is oraclevcn.com. |
display_name | string | The user-friendly name of the ODB network. |
ec_2_placement_group_ids | array | The list of EC2 Placement Group IDs associated with your ODB network. |
managed_services | object | The managed services configuration for the ODB network. |
oci_dns_forwarding_configs | array | The DNS resolver endpoint in OCI for forwarding DNS queries for the ociPrivateZone domain. |
oci_network_anchor_id | string | The unique identifier of the OCI network anchor for the ODB network. |
oci_network_anchor_url | string | The URL of the OCI network anchor for the ODB network. |
oci_resource_anchor_name | string | The name of the OCI resource anchor associated with the ODB network. |
oci_vcn_id | string | The Oracle Cloud ID (OCID) for the Virtual Cloud Network (VCN) associated with the ODB network. |
oci_vcn_url | string | The URL for the VCN that's associated with the ODB network. |
odb_network_arn | string | The Amazon Resource Name (ARN) of the ODB network. |
odb_network_id | string | The unique identifier of the ODB network. (pattern: <code>(arn:(?:aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):[a-z0-9-]+:[a-z0-9-]*:[0-9]+:[a-z0-9-]+/[a-zA-Z0-9_ |
peered_cidrs | array | The list of CIDR ranges from the peered VPC that are allowed access to the ODB network. |
percent_progress | number (float) | The amount of progress made on the current operation on the ODB network, expressed as a percentage. |
status | string | The current status of the ODB network. (AVAILABLE, FAILED, PROVISIONING, TERMINATED, TERMINATING, UPDATING, MAINTENANCE_IN_PROGRESS) |
status_reason | string | Additional information about the current status of the ODB network. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_odb_network | select | region | Returns information about the specified ODB network. | |
list_odb_networks | select | region | Returns information about the ODB networks owned by your Amazon Web Services account. | |
create_odb_network | insert | region, displayName, clientSubnetCidr | Creates an ODB network. | |
update_odb_network | update | region, odbNetworkId | Updates properties of a specified ODB network. | |
delete_odb_network | delete | region | Deletes the specified ODB network. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_odb_network
- list_odb_networks
Returns information about the specified ODB network.
SELECT
availability_zone,
availability_zone_id,
backup_subnet_cidr,
client_subnet_cidr,
created_at,
custom_domain_name,
default_dns_prefix,
display_name,
ec_2_placement_group_ids,
managed_services,
oci_dns_forwarding_configs,
oci_network_anchor_id,
oci_network_anchor_url,
oci_resource_anchor_name,
oci_vcn_id,
oci_vcn_url,
odb_network_arn,
odb_network_id,
peered_cidrs,
percent_progress,
status,
status_reason
FROM aws.odb.odb_networks
WHERE region = '{{ region }}' -- required
;
Returns information about the ODB networks owned by your Amazon Web Services account.
SELECT
availability_zone,
availability_zone_id,
backup_subnet_cidr,
client_subnet_cidr,
created_at,
custom_domain_name,
default_dns_prefix,
display_name,
ec_2_placement_group_ids,
managed_services,
oci_dns_forwarding_configs,
oci_network_anchor_id,
oci_network_anchor_url,
oci_resource_anchor_name,
oci_vcn_id,
oci_vcn_url,
odb_network_arn,
odb_network_id,
peered_cidrs,
percent_progress,
status,
status_reason
FROM aws.odb.odb_networks
WHERE region = '{{ region }}' -- required
;
INSERT examples
- create_odb_network
- Manifest
Creates an ODB network.
INSERT INTO aws.odb.odb_networks (
displayName,
availabilityZone,
availabilityZoneId,
clientSubnetCidr,
backupSubnetCidr,
customDomainName,
defaultDnsPrefix,
clientToken,
s3Access,
zeroEtlAccess,
stsAccess,
kmsAccess,
s3PolicyDocument,
stsPolicyDocument,
kmsPolicyDocument,
crossRegionS3RestoreSourcesToEnable,
tags,
region
)
SELECT
'{{ displayName }}' /* required */,
'{{ availabilityZone }}',
'{{ availabilityZoneId }}',
'{{ clientSubnetCidr }}' /* required */,
'{{ backupSubnetCidr }}',
'{{ customDomainName }}',
'{{ defaultDnsPrefix }}',
'{{ clientToken }}',
'{{ s3Access }}',
'{{ zeroEtlAccess }}',
'{{ stsAccess }}',
'{{ kmsAccess }}',
'{{ s3PolicyDocument }}',
'{{ stsPolicyDocument }}',
'{{ kmsPolicyDocument }}',
'{{ crossRegionS3RestoreSourcesToEnable }}',
'{{ tags }}',
'{{ region }}'
RETURNING
display_name,
odb_network_id,
status,
status_reason
;
# Description fields are for documentation purposes
- name: odb_networks
props:
- name: region
value: "{{ region }}"
description: Required parameter for the odb_networks resource.
- name: displayName
value: "{{ displayName }}"
description: |
A user-friendly name for the ODB network.
- name: availabilityZone
value: "{{ availabilityZone }}"
description: |
The Amazon Web Services Availability Zone (AZ) where the ODB network is located. This operation requires that you specify a value for either availabilityZone or availabilityZoneId.
- name: availabilityZoneId
value: "{{ availabilityZoneId }}"
description: |
The AZ ID of the AZ where the ODB network is located. This operation requires that you specify a value for either availabilityZone or availabilityZoneId.
- name: clientSubnetCidr
value: "{{ clientSubnetCidr }}"
description: |
The CIDR range of the client subnet for the ODB network. Constraints: Must not overlap with the CIDR range of the backup subnet. Must not overlap with the CIDR ranges of the VPCs that are connected to the ODB network. Must not use the following CIDR ranges that are reserved by OCI: 100.106.0.0/16 and 100.107.0.0/16 169.254.0.0/16 224.0.0.0 - 239.255.255.255 240.0.0.0 - 255.255.255.255
- name: backupSubnetCidr
value: "{{ backupSubnetCidr }}"
description: |
The CIDR range of the backup subnet for the ODB network. Constraints: Must not overlap with the CIDR range of the client subnet. Must not overlap with the CIDR ranges of the VPCs that are connected to the ODB network. Must not use the following CIDR ranges that are reserved by OCI: 100.106.0.0/16 and 100.107.0.0/16 169.254.0.0/16 224.0.0.0 - 239.255.255.255 240.0.0.0 - 255.255.255.255
- name: customDomainName
value: "{{ customDomainName }}"
description: |
The domain name to use for the resources in the ODB network.
- name: defaultDnsPrefix
value: "{{ defaultDnsPrefix }}"
description: |
The DNS prefix to the default DNS domain name. The default DNS domain name is oraclevcn.com.
- name: clientToken
value: "{{ clientToken }}"
description: |
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The client token is valid for up to 24 hours after it's first used.
- name: s3Access
value: "{{ s3Access }}"
description: |
Specifies the configuration for Amazon S3 access from the ODB network.
valid_values: ['ENABLED', 'DISABLED']
- name: zeroEtlAccess
value: "{{ zeroEtlAccess }}"
description: |
Specifies the configuration for Zero-ETL access from the ODB network.
valid_values: ['ENABLED', 'DISABLED']
- name: stsAccess
value: "{{ stsAccess }}"
description: |
The Amazon Web Services Security Token Service (STS) access configuration for the ODB network.
valid_values: ['ENABLED', 'DISABLED']
- name: kmsAccess
value: "{{ kmsAccess }}"
description: |
The Amazon Web Services Key Management Service (KMS) access configuration for the ODB network.
valid_values: ['ENABLED', 'DISABLED']
- name: s3PolicyDocument
value: "{{ s3PolicyDocument }}"
description: |
Specifies the endpoint policy for Amazon S3 access from the ODB network.
- name: stsPolicyDocument
value: "{{ stsPolicyDocument }}"
description: |
The Amazon Web Services Security Token Service (STS) policy document that defines permissions for token service usage within the ODB network.
- name: kmsPolicyDocument
value: "{{ kmsPolicyDocument }}"
description: |
The Amazon Web Services Key Management Service (KMS) policy document that defines permissions for key usage within the ODB network.
- name: crossRegionS3RestoreSourcesToEnable
value:
- "{{ crossRegionS3RestoreSourcesToEnable }}"
description: |
The cross-Region Amazon S3 restore sources to enable for the ODB network.
- name: tags
value: "{{ tags }}"
description: |
The list of resource tags to apply to the ODB network.
UPDATE examples
- update_odb_network
Updates properties of a specified ODB network.
UPDATE aws.odb.odb_networks
SET
odbNetworkId = '{{ odbNetworkId }}',
displayName = '{{ displayName }}',
peeredCidrsToBeAdded = '{{ peeredCidrsToBeAdded }}',
peeredCidrsToBeRemoved = '{{ peeredCidrsToBeRemoved }}',
s3Access = '{{ s3Access }}',
zeroEtlAccess = '{{ zeroEtlAccess }}',
stsAccess = '{{ stsAccess }}',
kmsAccess = '{{ kmsAccess }}',
s3PolicyDocument = '{{ s3PolicyDocument }}',
stsPolicyDocument = '{{ stsPolicyDocument }}',
kmsPolicyDocument = '{{ kmsPolicyDocument }}',
crossRegionS3RestoreSourcesToEnable = '{{ crossRegionS3RestoreSourcesToEnable }}',
crossRegionS3RestoreSourcesToDisable = '{{ crossRegionS3RestoreSourcesToDisable }}'
WHERE
region = '{{ region }}' --required
AND odbNetworkId = '{{ odbNetworkId }}' --required
RETURNING
display_name,
odb_network_id,
status,
status_reason;
DELETE examples
- delete_odb_network
Deletes the specified ODB network.
DELETE FROM aws.odb.odb_networks
WHERE region = '{{ region }}' --required
;