pulumi-gcp 7.24.0a1716510380__py3-none-any.whl → 7.24.0a1716588893__py3-none-any.whl

pulumi_gcp/dataproc/job_iam_member.py

@@ -293,7 +293,7 @@ class JobIAMMember(pulumi.CustomResource):
 
         > **Note:** `dataproc.JobIAMBinding` resources **can be** used in conjunction with `dataproc.JobIAMMember` resources **only if** they do not grant privilege to the same role.
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -310,7 +310,7 @@ class JobIAMMember(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -322,7 +322,7 @@ class JobIAMMember(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi
@@ -334,7 +334,7 @@ class JobIAMMember(pulumi.CustomResource):
             member="user:jane@example.com")
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -351,7 +351,7 @@ class JobIAMMember(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -363,7 +363,7 @@ class JobIAMMember(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi
@@ -438,7 +438,7 @@ class JobIAMMember(pulumi.CustomResource):
 
         > **Note:** `dataproc.JobIAMBinding` resources **can be** used in conjunction with `dataproc.JobIAMMember` resources **only if** they do not grant privilege to the same role.
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -455,7 +455,7 @@ class JobIAMMember(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -467,7 +467,7 @@ class JobIAMMember(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi
@@ -479,7 +479,7 @@ class JobIAMMember(pulumi.CustomResource):
             member="user:jane@example.com")
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -496,7 +496,7 @@ class JobIAMMember(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -508,7 +508,7 @@ class JobIAMMember(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi

pulumi_gcp/dataproc/job_iam_policy.py

@@ -198,7 +198,7 @@ class JobIAMPolicy(pulumi.CustomResource):
 
         > **Note:** `dataproc.JobIAMBinding` resources **can be** used in conjunction with `dataproc.JobIAMMember` resources **only if** they do not grant privilege to the same role.
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -215,7 +215,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -227,7 +227,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi
@@ -239,7 +239,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             member="user:jane@example.com")
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -256,7 +256,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -268,7 +268,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi
@@ -333,7 +333,7 @@ class JobIAMPolicy(pulumi.CustomResource):
 
         > **Note:** `dataproc.JobIAMBinding` resources **can be** used in conjunction with `dataproc.JobIAMMember` resources **only if** they do not grant privilege to the same role.
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -350,7 +350,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -362,7 +362,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi
@@ -374,7 +374,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             member="user:jane@example.com")
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_policy
+        ## dataproc.JobIAMPolicy
 
         ```python
         import pulumi
@@ -391,7 +391,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             policy_data=admin.policy_data)
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_binding
+        ## dataproc.JobIAMBinding
 
         ```python
         import pulumi
@@ -403,7 +403,7 @@ class JobIAMPolicy(pulumi.CustomResource):
             members=["user:jane@example.com"])
         ```
 
-        ## google\\_dataproc\\_job\\_iam\\_member
+        ## dataproc.JobIAMMember
 
         ```python
         import pulumi

pulumi_gcp/dataproc/metastore_federation.py

@@ -357,6 +357,8 @@ class MetastoreFederation(pulumi.CustomResource):
                  version: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        A managed metastore federation.
+
         ## Example Usage
 
         ### Dataproc Metastore Federation Basic
@@ -460,6 +462,8 @@ class MetastoreFederation(pulumi.CustomResource):
                  args: MetastoreFederationArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        A managed metastore federation.
+
         ## Example Usage
 
         ### Dataproc Metastore Federation Basic

pulumi_gcp/dataproc/metastore_federation_iam_binding.py

@@ -287,6 +287,110 @@ class MetastoreFederationIamBinding(pulumi.CustomResource):
                  role: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        Three different resources help you manage your IAM policy for Dataproc metastore Federation. Each of these resources serves a different use case:
+
+        * `dataproc.MetastoreFederationIamPolicy`: Authoritative. Sets the IAM policy for the federation and replaces any existing policy already attached.
+        * `dataproc.MetastoreFederationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the federation are preserved.
+        * `dataproc.MetastoreFederationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the federation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `dataproc.MetastoreFederationIamPolicy`: Retrieves the IAM policy for the federation
+
+        > **Note:** `dataproc.MetastoreFederationIamPolicy` **cannot** be used in conjunction with `dataproc.MetastoreFederationIamBinding` and `dataproc.MetastoreFederationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `dataproc.MetastoreFederationIamBinding` resources **can be** used in conjunction with `dataproc.MetastoreFederationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:
@@ -353,6 +457,110 @@ class MetastoreFederationIamBinding(pulumi.CustomResource):
                  args: MetastoreFederationIamBindingArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Three different resources help you manage your IAM policy for Dataproc metastore Federation. Each of these resources serves a different use case:
+
+        * `dataproc.MetastoreFederationIamPolicy`: Authoritative. Sets the IAM policy for the federation and replaces any existing policy already attached.
+        * `dataproc.MetastoreFederationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the federation are preserved.
+        * `dataproc.MetastoreFederationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the federation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `dataproc.MetastoreFederationIamPolicy`: Retrieves the IAM policy for the federation
+
+        > **Note:** `dataproc.MetastoreFederationIamPolicy` **cannot** be used in conjunction with `dataproc.MetastoreFederationIamBinding` and `dataproc.MetastoreFederationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `dataproc.MetastoreFederationIamBinding` resources **can be** used in conjunction with `dataproc.MetastoreFederationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:

pulumi_gcp/dataproc/metastore_federation_iam_member.py

@@ -287,6 +287,110 @@ class MetastoreFederationIamMember(pulumi.CustomResource):
                  role: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        Three different resources help you manage your IAM policy for Dataproc metastore Federation. Each of these resources serves a different use case:
+
+        * `dataproc.MetastoreFederationIamPolicy`: Authoritative. Sets the IAM policy for the federation and replaces any existing policy already attached.
+        * `dataproc.MetastoreFederationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the federation are preserved.
+        * `dataproc.MetastoreFederationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the federation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `dataproc.MetastoreFederationIamPolicy`: Retrieves the IAM policy for the federation
+
+        > **Note:** `dataproc.MetastoreFederationIamPolicy` **cannot** be used in conjunction with `dataproc.MetastoreFederationIamBinding` and `dataproc.MetastoreFederationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `dataproc.MetastoreFederationIamBinding` resources **can be** used in conjunction with `dataproc.MetastoreFederationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms:
@@ -353,6 +457,110 @@ class MetastoreFederationIamMember(pulumi.CustomResource):
                  args: MetastoreFederationIamMemberArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Three different resources help you manage your IAM policy for Dataproc metastore Federation. Each of these resources serves a different use case:
+
+        * `dataproc.MetastoreFederationIamPolicy`: Authoritative. Sets the IAM policy for the federation and replaces any existing policy already attached.
+        * `dataproc.MetastoreFederationIamBinding`: Authoritative for a given role. Updates the IAM policy to grant a role to a list of members. Other roles within the IAM policy for the federation are preserved.
+        * `dataproc.MetastoreFederationIamMember`: Non-authoritative. Updates the IAM policy to grant a role to a new member. Other members for the role for the federation are preserved.
+
+        A data source can be used to retrieve policy data in advent you do not need creation
+
+        * `dataproc.MetastoreFederationIamPolicy`: Retrieves the IAM policy for the federation
+
+        > **Note:** `dataproc.MetastoreFederationIamPolicy` **cannot** be used in conjunction with `dataproc.MetastoreFederationIamBinding` and `dataproc.MetastoreFederationIamMember` or they will fight over what your policy should be.
+
+        > **Note:** `dataproc.MetastoreFederationIamBinding` resources **can be** used in conjunction with `dataproc.MetastoreFederationIamMember` resources **only if** they do not grant privilege to the same role.
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
+        ## dataproc.MetastoreFederationIamPolicy
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        admin = gcp.organizations.get_iam_policy(bindings=[gcp.organizations.GetIAMPolicyBindingArgs(
+            role="roles/viewer",
+            members=["user:jane@example.com"],
+        )])
+        policy = gcp.dataproc.MetastoreFederationIamPolicy("policy",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            policy_data=admin.policy_data)
+        ```
+
+        ## dataproc.MetastoreFederationIamBinding
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        binding = gcp.dataproc.MetastoreFederationIamBinding("binding",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            members=["user:jane@example.com"])
+        ```
+
+        ## dataproc.MetastoreFederationIamMember
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        member = gcp.dataproc.MetastoreFederationIamMember("member",
+            project=default["project"],
+            location=default["location"],
+            federation_id=default["federationId"],
+            role="roles/viewer",
+            member="user:jane@example.com")
+        ```
+
         ## Import
 
         For all import syntaxes, the "resource in question" can take any of the following forms: