pulumi-linode 5.5.0a1760250058__tar.gz → 5.5.0a1760422897__tar.gz

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pulumi_linode
-Version: 5.5.0a1760250058
+Version: 5.5.0a1760422897
 Summary: A Pulumi package for creating and managing linode cloud resources.
 License: Apache-2.0
 Project-URL: Homepage, https://pulumi.io

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode/database_mysql_v2.py

@@ -1682,6 +1682,97 @@ class DatabaseMysqlV2(pulumi.CustomResource):
 
         Creating a complex MySQL database:
 
+        Creating a MySQL database with engine config fields specified:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabaseMysqlV2("foobar",
+            label="mydatabase",
+            engine_id="mysql/8",
+            region="us-mia",
+            type="g6-nanode-1",
+            engine_config_binlog_retention_period=3600,
+            engine_config_mysql_connect_timeout=10,
+            engine_config_mysql_default_time_zone="+00:00",
+            engine_config_mysql_group_concat_max_len=4096,
+            engine_config_mysql_information_schema_stats_expiry=3600,
+            engine_config_mysql_innodb_change_buffer_max_size=25,
+            engine_config_mysql_innodb_flush_neighbors=0,
+            engine_config_mysql_innodb_ft_min_token_size=7,
+            engine_config_mysql_innodb_ft_server_stopword_table="mysql/innodb_ft_default_stopword",
+            engine_config_mysql_innodb_lock_wait_timeout=300,
+            engine_config_mysql_innodb_log_buffer_size=16777216,
+            engine_config_mysql_innodb_online_alter_log_max_size=268435456,
+            engine_config_mysql_innodb_read_io_threads=4,
+            engine_config_mysql_innodb_rollback_on_timeout=True,
+            engine_config_mysql_innodb_thread_concurrency=8,
+            engine_config_mysql_innodb_write_io_threads=4,
+            engine_config_mysql_interactive_timeout=300,
+            engine_config_mysql_internal_tmp_mem_storage_engine="TempTable",
+            engine_config_mysql_max_allowed_packet=67108864,
+            engine_config_mysql_max_heap_table_size=16777216,
+            engine_config_mysql_net_buffer_length=16384,
+            engine_config_mysql_net_read_timeout=30,
+            engine_config_mysql_net_write_timeout=30,
+            engine_config_mysql_sort_buffer_size=262144,
+            engine_config_mysql_sql_mode="TRADITIONAL,ANSI",
+            engine_config_mysql_sql_require_primary_key=False,
+            engine_config_mysql_tmp_table_size=16777216,
+            engine_config_mysql_wait_timeout=28800)
+        ```
+
+        Creating a forked MySQL database:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabaseMysqlV2("foobar",
+            label="mydatabase",
+            engine_id="mysql/8",
+            region="us-mia",
+            type="g6-nanode-1",
+            fork_source=12345)
+        ```
+
+        Creating a MySQL database hidden behind a VPC:
+
+        > **_NOTE:_** The name of the default database in the returned database cluster is `defaultdb`.
+
+        ## pending_updates
+
+        The following arguments are exposed by each entry in the `pending_updates` attribute:
+
+        * `deadline` - The time when a mandatory update needs to be applied.
+
+        * `description` - A description of the update.
+
+        * `planned_for` - The date and time a maintenance update will be applied.
+
+        ## updates
+
+        The following arguments are supported in the `updates` specification block:
+
+        * `day_of_week` - (Required) The day to perform maintenance. (`monday`, `tuesday`, ...)
+
+        * `duration` - (Required) The maximum maintenance window time in hours. (`1`..`3`)
+
+        * `frequency` - (Required) The frequency at which maintenance occurs. (`weekly`)
+
+        * `hour_of_day` - (Required) The hour to begin maintenance based in UTC time. (`0`..`23`)
+
+        ## private_network
+
+        The following arguments are supported in the `private_network` specification block:
+
+        * `vpc_id` - (Required) The ID of the virtual private cloud (VPC) to restrict access to this database using.
+
+        * `subnet_id` - (Required) The ID of the VPC subnet to restrict access to this database using.
+
+        * `public_access` - (Optional) Set to `true` to allow clients outside the VPC to connect to the database using a public IP address. (Default `false`)
+
         ## Import
 
         Linode MySQL Databases can be imported using the `id`, e.g.
@@ -1781,6 +1872,97 @@ class DatabaseMysqlV2(pulumi.CustomResource):
 
         Creating a complex MySQL database:
 
+        Creating a MySQL database with engine config fields specified:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabaseMysqlV2("foobar",
+            label="mydatabase",
+            engine_id="mysql/8",
+            region="us-mia",
+            type="g6-nanode-1",
+            engine_config_binlog_retention_period=3600,
+            engine_config_mysql_connect_timeout=10,
+            engine_config_mysql_default_time_zone="+00:00",
+            engine_config_mysql_group_concat_max_len=4096,
+            engine_config_mysql_information_schema_stats_expiry=3600,
+            engine_config_mysql_innodb_change_buffer_max_size=25,
+            engine_config_mysql_innodb_flush_neighbors=0,
+            engine_config_mysql_innodb_ft_min_token_size=7,
+            engine_config_mysql_innodb_ft_server_stopword_table="mysql/innodb_ft_default_stopword",
+            engine_config_mysql_innodb_lock_wait_timeout=300,
+            engine_config_mysql_innodb_log_buffer_size=16777216,
+            engine_config_mysql_innodb_online_alter_log_max_size=268435456,
+            engine_config_mysql_innodb_read_io_threads=4,
+            engine_config_mysql_innodb_rollback_on_timeout=True,
+            engine_config_mysql_innodb_thread_concurrency=8,
+            engine_config_mysql_innodb_write_io_threads=4,
+            engine_config_mysql_interactive_timeout=300,
+            engine_config_mysql_internal_tmp_mem_storage_engine="TempTable",
+            engine_config_mysql_max_allowed_packet=67108864,
+            engine_config_mysql_max_heap_table_size=16777216,
+            engine_config_mysql_net_buffer_length=16384,
+            engine_config_mysql_net_read_timeout=30,
+            engine_config_mysql_net_write_timeout=30,
+            engine_config_mysql_sort_buffer_size=262144,
+            engine_config_mysql_sql_mode="TRADITIONAL,ANSI",
+            engine_config_mysql_sql_require_primary_key=False,
+            engine_config_mysql_tmp_table_size=16777216,
+            engine_config_mysql_wait_timeout=28800)
+        ```
+
+        Creating a forked MySQL database:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabaseMysqlV2("foobar",
+            label="mydatabase",
+            engine_id="mysql/8",
+            region="us-mia",
+            type="g6-nanode-1",
+            fork_source=12345)
+        ```
+
+        Creating a MySQL database hidden behind a VPC:
+
+        > **_NOTE:_** The name of the default database in the returned database cluster is `defaultdb`.
+
+        ## pending_updates
+
+        The following arguments are exposed by each entry in the `pending_updates` attribute:
+
+        * `deadline` - The time when a mandatory update needs to be applied.
+
+        * `description` - A description of the update.
+
+        * `planned_for` - The date and time a maintenance update will be applied.
+
+        ## updates
+
+        The following arguments are supported in the `updates` specification block:
+
+        * `day_of_week` - (Required) The day to perform maintenance. (`monday`, `tuesday`, ...)
+
+        * `duration` - (Required) The maximum maintenance window time in hours. (`1`..`3`)
+
+        * `frequency` - (Required) The frequency at which maintenance occurs. (`weekly`)
+
+        * `hour_of_day` - (Required) The hour to begin maintenance based in UTC time. (`0`..`23`)
+
+        ## private_network
+
+        The following arguments are supported in the `private_network` specification block:
+
+        * `vpc_id` - (Required) The ID of the virtual private cloud (VPC) to restrict access to this database using.
+
+        * `subnet_id` - (Required) The ID of the VPC subnet to restrict access to this database using.
+
+        * `public_access` - (Optional) Set to `true` to allow clients outside the VPC to connect to the database using a public IP address. (Default `false`)
+
         ## Import
 
         Linode MySQL Databases can be imported using the `id`, e.g.

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode/database_postgresql_v2.py

@@ -2309,6 +2309,116 @@ class DatabasePostgresqlV2(pulumi.CustomResource):
 
         Creating a complex PostgreSQL database:
 
+        Creating a PostgreSQL database with engine config fields specified:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabasePostgresqlV2("foobar",
+            label="mydatabase",
+            engine_id="postgresql/16",
+            region="us-mia",
+            type="g6-nanode-1",
+            engine_config_pg_autovacuum_analyze_scale_factor=0.1,
+            engine_config_pg_autovacuum_analyze_threshold=50,
+            engine_config_pg_autovacuum_max_workers=3,
+            engine_config_pg_autovacuum_naptime=100,
+            engine_config_pg_autovacuum_vacuum_cost_delay=20,
+            engine_config_pg_autovacuum_vacuum_cost_limit=200,
+            engine_config_pg_autovacuum_vacuum_scale_factor=0.2,
+            engine_config_pg_autovacuum_vacuum_threshold=100,
+            engine_config_pg_bgwriter_delay=1000,
+            engine_config_pg_bgwriter_flush_after=512,
+            engine_config_pg_bgwriter_lru_maxpages=100,
+            engine_config_pg_bgwriter_lru_multiplier=2,
+            engine_config_pg_deadlock_timeout=1000,
+            engine_config_pg_default_toast_compression="pglz",
+            engine_config_pg_idle_in_transaction_session_timeout=60000,
+            engine_config_pg_jit=True,
+            engine_config_pg_max_files_per_process=1000,
+            engine_config_pg_max_locks_per_transaction=64,
+            engine_config_pg_max_logical_replication_workers=4,
+            engine_config_pg_max_parallel_workers=8,
+            engine_config_pg_max_parallel_workers_per_gather=2,
+            engine_config_pg_max_pred_locks_per_transaction=128,
+            engine_config_pg_max_replication_slots=8,
+            engine_config_pg_max_slot_wal_keep_size=128,
+            engine_config_pg_max_stack_depth=2097152,
+            engine_config_pg_max_standby_archive_delay=60000,
+            engine_config_pg_max_standby_streaming_delay=60000,
+            engine_config_pg_max_wal_senders=20,
+            engine_config_pg_max_worker_processes=8,
+            engine_config_pg_password_encryption="scram-sha-256",
+            engine_config_pg_pg_partman_bgw_interval=3600,
+            engine_config_pg_pg_partman_bgw_role="myrolename",
+            engine_config_pg_pg_stat_monitor_pgsm_enable_query_plan=True,
+            engine_config_pg_pg_stat_monitor_pgsm_max_buckets=5,
+            engine_config_pg_pg_stat_statements_track="all",
+            engine_config_pg_temp_file_limit=100,
+            engine_config_pg_timezone="Europe/Helsinki",
+            engine_config_pg_track_activity_query_size=2048,
+            engine_config_pg_track_commit_timestamp="on",
+            engine_config_pg_track_functions="all",
+            engine_config_pg_track_io_timing="on",
+            engine_config_pg_wal_sender_timeout=60000,
+            engine_config_pg_wal_writer_delay=200,
+            engine_config_pg_stat_monitor_enable=True,
+            engine_config_pglookout_max_failover_replication_time_lag=10000,
+            engine_config_shared_buffers_percentage=25,
+            engine_config_work_mem=400)
+        ```
+
+        Creating a forked PostgreSQL database:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabasePostgresqlV2("foobar",
+            label="mydatabase",
+            engine_id="postgresql/16",
+            region="us-mia",
+            type="g6-nanode-1",
+            fork_source=12345)
+        ```
+
+        Creating a PostgreSQL database hidden behind a VPC:
+
+        > **_NOTE:_** The name of the default database in the returned database cluster is `defaultdb`.
+
+        ## pending_updates
+
+        The following arguments are exposed by each entry in the `pending_updates` attribute:
+
+        * `deadline` - The time when a mandatory update needs to be applied.
+
+        * `description` - A description of the update.
+
+        * `planned_for` - The date and time a maintenance update will be applied.
+
+        ## updates
+
+        The following arguments are supported in the `updates` specification block:
+
+        * `day_of_week` - (Required) The day to perform maintenance. (`monday`, `tuesday`, ...)
+
+        * `duration` - (Required) The maximum maintenance window time in hours. (`1`..`3`)
+
+        * `frequency` - (Required) The frequency at which maintenance occurs. (`weekly`)
+
+        * `hour_of_day` - (Required) The hour to begin maintenance based in UTC time. (`0`..`23`)
+
+        ## private_network
+
+        The following arguments are supported in the `private_network` specification block:
+
+        * `vpc_id` - (Required) The ID of the virtual private cloud (VPC) to restrict access to this database using.
+
+        * `subnet_id` - (Required) The ID of the VPC subnet to restrict access to this database using.
+
+        * `public_access` - (Optional) Set to `true` to allow clients outside the VPC to connect to the database using a public IP address. (Default `false`)
+
         ## Import
 
         Linode PostgreSQL Databases can be imported using the `id`, e.g.
@@ -2427,6 +2537,116 @@ class DatabasePostgresqlV2(pulumi.CustomResource):
 
         Creating a complex PostgreSQL database:
 
+        Creating a PostgreSQL database with engine config fields specified:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabasePostgresqlV2("foobar",
+            label="mydatabase",
+            engine_id="postgresql/16",
+            region="us-mia",
+            type="g6-nanode-1",
+            engine_config_pg_autovacuum_analyze_scale_factor=0.1,
+            engine_config_pg_autovacuum_analyze_threshold=50,
+            engine_config_pg_autovacuum_max_workers=3,
+            engine_config_pg_autovacuum_naptime=100,
+            engine_config_pg_autovacuum_vacuum_cost_delay=20,
+            engine_config_pg_autovacuum_vacuum_cost_limit=200,
+            engine_config_pg_autovacuum_vacuum_scale_factor=0.2,
+            engine_config_pg_autovacuum_vacuum_threshold=100,
+            engine_config_pg_bgwriter_delay=1000,
+            engine_config_pg_bgwriter_flush_after=512,
+            engine_config_pg_bgwriter_lru_maxpages=100,
+            engine_config_pg_bgwriter_lru_multiplier=2,
+            engine_config_pg_deadlock_timeout=1000,
+            engine_config_pg_default_toast_compression="pglz",
+            engine_config_pg_idle_in_transaction_session_timeout=60000,
+            engine_config_pg_jit=True,
+            engine_config_pg_max_files_per_process=1000,
+            engine_config_pg_max_locks_per_transaction=64,
+            engine_config_pg_max_logical_replication_workers=4,
+            engine_config_pg_max_parallel_workers=8,
+            engine_config_pg_max_parallel_workers_per_gather=2,
+            engine_config_pg_max_pred_locks_per_transaction=128,
+            engine_config_pg_max_replication_slots=8,
+            engine_config_pg_max_slot_wal_keep_size=128,
+            engine_config_pg_max_stack_depth=2097152,
+            engine_config_pg_max_standby_archive_delay=60000,
+            engine_config_pg_max_standby_streaming_delay=60000,
+            engine_config_pg_max_wal_senders=20,
+            engine_config_pg_max_worker_processes=8,
+            engine_config_pg_password_encryption="scram-sha-256",
+            engine_config_pg_pg_partman_bgw_interval=3600,
+            engine_config_pg_pg_partman_bgw_role="myrolename",
+            engine_config_pg_pg_stat_monitor_pgsm_enable_query_plan=True,
+            engine_config_pg_pg_stat_monitor_pgsm_max_buckets=5,
+            engine_config_pg_pg_stat_statements_track="all",
+            engine_config_pg_temp_file_limit=100,
+            engine_config_pg_timezone="Europe/Helsinki",
+            engine_config_pg_track_activity_query_size=2048,
+            engine_config_pg_track_commit_timestamp="on",
+            engine_config_pg_track_functions="all",
+            engine_config_pg_track_io_timing="on",
+            engine_config_pg_wal_sender_timeout=60000,
+            engine_config_pg_wal_writer_delay=200,
+            engine_config_pg_stat_monitor_enable=True,
+            engine_config_pglookout_max_failover_replication_time_lag=10000,
+            engine_config_shared_buffers_percentage=25,
+            engine_config_work_mem=400)
+        ```
+
+        Creating a forked PostgreSQL database:
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.DatabasePostgresqlV2("foobar",
+            label="mydatabase",
+            engine_id="postgresql/16",
+            region="us-mia",
+            type="g6-nanode-1",
+            fork_source=12345)
+        ```
+
+        Creating a PostgreSQL database hidden behind a VPC:
+
+        > **_NOTE:_** The name of the default database in the returned database cluster is `defaultdb`.
+
+        ## pending_updates
+
+        The following arguments are exposed by each entry in the `pending_updates` attribute:
+
+        * `deadline` - The time when a mandatory update needs to be applied.
+
+        * `description` - A description of the update.
+
+        * `planned_for` - The date and time a maintenance update will be applied.
+
+        ## updates
+
+        The following arguments are supported in the `updates` specification block:
+
+        * `day_of_week` - (Required) The day to perform maintenance. (`monday`, `tuesday`, ...)
+
+        * `duration` - (Required) The maximum maintenance window time in hours. (`1`..`3`)
+
+        * `frequency` - (Required) The frequency at which maintenance occurs. (`weekly`)
+
+        * `hour_of_day` - (Required) The hour to begin maintenance based in UTC time. (`0`..`23`)
+
+        ## private_network
+
+        The following arguments are supported in the `private_network` specification block:
+
+        * `vpc_id` - (Required) The ID of the virtual private cloud (VPC) to restrict access to this database using.
+
+        * `subnet_id` - (Required) The ID of the VPC subnet to restrict access to this database using.
+
+        * `public_access` - (Optional) Set to `true` to allow clients outside the VPC to connect to the database using a public IP address. (Default `false`)
+
         ## Import
 
         Linode PostgreSQL Databases can be imported using the `id`, e.g.

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode/instance.py

@@ -1422,6 +1422,10 @@ class Instance(pulumi.CustomResource):
             private_ip=True)
         ```
 
+        ### Linode Instance with Explicit Configs and Disks
+
+        Using explicit Instance Configs and Disks it is possible to create a more elaborate Linode instance. This can be used to provision multiple disks and volumes during Instance creation.
+
         ### Linode Instance Assigned to a Placement Group
 
         The following example shows how one might use this resource to configure a Linode instance assigned to a
@@ -1574,6 +1578,10 @@ class Instance(pulumi.CustomResource):
             private_ip=True)
         ```
 
+        ### Linode Instance with Explicit Configs and Disks
+
+        Using explicit Instance Configs and Disks it is possible to create a more elaborate Linode instance. This can be used to provision multiple disks and volumes during Instance creation.
+
         ### Linode Instance Assigned to a Placement Group
 
         The following example shows how one might use this resource to configure a Linode instance assigned to a

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode/instance_config.py

@@ -513,6 +513,8 @@ class InstanceConfig(pulumi.CustomResource):
 
         Creating a simple bootable Linode Instance Configuration Profile:
 
+        Creating a complex bootable Instance Configuration Profile with a VPC:
+
         ## Import
 
         Instance Configs can be imported using the `linode_id` followed by the Instance Config `id` separated by a comma, e.g.
@@ -556,6 +558,8 @@ class InstanceConfig(pulumi.CustomResource):
 
         Creating a simple bootable Linode Instance Configuration Profile:
 
+        Creating a complex bootable Instance Configuration Profile with a VPC:
+
         ## Import
 
         Instance Configs can be imported using the `linode_id` followed by the Instance Config `id` separated by a comma, e.g.

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode/networking_ip_assignment.py

@@ -111,6 +111,12 @@ class NetworkingIpAssignment(pulumi.CustomResource):
 
         For more information, see the corresponding [API documentation](https://techdocs.akamai.com/linode-api/reference/post-assign-ips).
 
+        ## Example Usage
+
+        ## Import
+
+        Network IP assignments cannot be imported.
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Sequence[pulumi.Input[Union['NetworkingIpAssignmentAssignmentArgs', 'NetworkingIpAssignmentAssignmentArgsDict']]]] assignments: A list of IP/Linode assignments to apply.
@@ -127,6 +133,12 @@ class NetworkingIpAssignment(pulumi.CustomResource):
 
         For more information, see the corresponding [API documentation](https://techdocs.akamai.com/linode-api/reference/post-assign-ips).
 
+        ## Example Usage
+
+        ## Import
+
+        Network IP assignments cannot be imported.
+
         :param str resource_name: The name of the resource.
         :param NetworkingIpAssignmentArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode/pulumi-plugin.json

@@ -1,5 +1,5 @@
 {
   "resource": true,
   "name": "linode",
-  "version": "5.5.0-alpha.1760250058"
+  "version": "5.5.0-alpha.1760422897"
 }

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode/volume.py

@@ -362,6 +362,17 @@ class Volume(pulumi.CustomResource):
 
         Volumes can also be attached using the Linode Instance config device map.
 
+        Volumes may also be cloned from existing volumes.
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.Volume("foobar",
+            label="my-cloned-volume",
+            source_volume_id=12345)
+        ```
+
         ## Import
 
         Linodes Volumes can be imported using the Linode Volume `id`, e.g.
@@ -414,6 +425,17 @@ class Volume(pulumi.CustomResource):
 
         Volumes can also be attached using the Linode Instance config device map.
 
+        Volumes may also be cloned from existing volumes.
+
+        ```python
+        import pulumi
+        import pulumi_linode as linode
+
+        foobar = linode.Volume("foobar",
+            label="my-cloned-volume",
+            source_volume_id=12345)
+        ```
+
         ## Import
 
         Linodes Volumes can be imported using the Linode Volume `id`, e.g.

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pulumi_linode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pulumi_linode
-Version: 5.5.0a1760250058
+Version: 5.5.0a1760422897
 Summary: A Pulumi package for creating and managing linode cloud resources.
 License: Apache-2.0
 Project-URL: Homepage, https://pulumi.io

{pulumi_linode-5.5.0a1760250058 → pulumi_linode-5.5.0a1760422897}/pyproject.toml

@@ -5,7 +5,7 @@
   keywords = ["pulumi", "linode"]
   readme = "README.md"
   requires-python = ">=3.9"
-  version = "5.5.0a1760250058"
+  version = "5.5.0a1760422897"
   [project.license]
     text = "Apache-2.0"
   [project.urls]