pulumi-gcp 8.11.0a1734348982__py3-none-any.whl → 8.12.0__py3-none-any.whl

pulumi_gcp/artifactregistry/outputs.py

@@ -722,7 +722,10 @@ class RepositoryRemoteRepositoryConfigCommonRepository(dict):
     def __init__(__self__, *,
                  uri: str):
         """
-        :param str uri: Specific uri to the Artifact Registory repository, e.g. `projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY`
+        :param str uri: One of:
+               a. Artifact Registry Repository resource, e.g. `projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY`
+               b. URI to the registry, e.g. `"https://registry-1.docker.io"`
+               c. URI to Artifact Registry Repository, e.g. `"https://REGION-docker.pkg.dev/UPSTREAM_PROJECT_ID/UPSTREAM_REPOSITORY"`
         """
         pulumi.set(__self__, "uri", uri)
 
@@ -730,7 +733,10 @@ class RepositoryRemoteRepositoryConfigCommonRepository(dict):
     @pulumi.getter
     def uri(self) -> str:
         """
-        Specific uri to the Artifact Registory repository, e.g. `projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY`
+        One of:
+        a. Artifact Registry Repository resource, e.g. `projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY`
+        b. URI to the registry, e.g. `"https://registry-1.docker.io"`
+        c. URI to Artifact Registry Repository, e.g. `"https://REGION-docker.pkg.dev/UPSTREAM_PROJECT_ID/UPSTREAM_REPOSITORY"`
         """
         return pulumi.get(self, "uri")
 
@@ -760,7 +766,7 @@ class RepositoryRemoteRepositoryConfigDockerRepository(dict):
                  custom_repository: Optional['outputs.RepositoryRemoteRepositoryConfigDockerRepositoryCustomRepository'] = None,
                  public_repository: Optional[str] = None):
         """
-        :param 'RepositoryRemoteRepositoryConfigDockerRepositoryCustomRepositoryArgs' custom_repository: Settings for a remote repository with a custom uri.
+        :param 'RepositoryRemoteRepositoryConfigDockerRepositoryCustomRepositoryArgs' custom_repository: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
                Structure is documented below.
         :param str public_repository: Address of the remote repository.
                Default value is `DOCKER_HUB`.
@@ -775,7 +781,7 @@ class RepositoryRemoteRepositoryConfigDockerRepository(dict):
     @pulumi.getter(name="customRepository")
     def custom_repository(self) -> Optional['outputs.RepositoryRemoteRepositoryConfigDockerRepositoryCustomRepository']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         Structure is documented below.
         """
         return pulumi.get(self, "custom_repository")
@@ -835,7 +841,7 @@ class RepositoryRemoteRepositoryConfigMavenRepository(dict):
                  custom_repository: Optional['outputs.RepositoryRemoteRepositoryConfigMavenRepositoryCustomRepository'] = None,
                  public_repository: Optional[str] = None):
         """
-        :param 'RepositoryRemoteRepositoryConfigMavenRepositoryCustomRepositoryArgs' custom_repository: Settings for a remote repository with a custom uri.
+        :param 'RepositoryRemoteRepositoryConfigMavenRepositoryCustomRepositoryArgs' custom_repository: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
                Structure is documented below.
         :param str public_repository: Address of the remote repository.
                Default value is `MAVEN_CENTRAL`.
@@ -850,7 +856,7 @@ class RepositoryRemoteRepositoryConfigMavenRepository(dict):
     @pulumi.getter(name="customRepository")
     def custom_repository(self) -> Optional['outputs.RepositoryRemoteRepositoryConfigMavenRepositoryCustomRepository']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         Structure is documented below.
         """
         return pulumi.get(self, "custom_repository")
@@ -910,7 +916,7 @@ class RepositoryRemoteRepositoryConfigNpmRepository(dict):
                  custom_repository: Optional['outputs.RepositoryRemoteRepositoryConfigNpmRepositoryCustomRepository'] = None,
                  public_repository: Optional[str] = None):
         """
-        :param 'RepositoryRemoteRepositoryConfigNpmRepositoryCustomRepositoryArgs' custom_repository: Settings for a remote repository with a custom uri.
+        :param 'RepositoryRemoteRepositoryConfigNpmRepositoryCustomRepositoryArgs' custom_repository: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
                Structure is documented below.
         :param str public_repository: Address of the remote repository.
                Default value is `NPMJS`.
@@ -925,7 +931,7 @@ class RepositoryRemoteRepositoryConfigNpmRepository(dict):
     @pulumi.getter(name="customRepository")
     def custom_repository(self) -> Optional['outputs.RepositoryRemoteRepositoryConfigNpmRepositoryCustomRepository']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         Structure is documented below.
         """
         return pulumi.get(self, "custom_repository")
@@ -985,7 +991,7 @@ class RepositoryRemoteRepositoryConfigPythonRepository(dict):
                  custom_repository: Optional['outputs.RepositoryRemoteRepositoryConfigPythonRepositoryCustomRepository'] = None,
                  public_repository: Optional[str] = None):
         """
-        :param 'RepositoryRemoteRepositoryConfigPythonRepositoryCustomRepositoryArgs' custom_repository: Settings for a remote repository with a custom uri.
+        :param 'RepositoryRemoteRepositoryConfigPythonRepositoryCustomRepositoryArgs' custom_repository: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
                Structure is documented below.
         :param str public_repository: Address of the remote repository.
                Default value is `PYPI`.
@@ -1000,7 +1006,7 @@ class RepositoryRemoteRepositoryConfigPythonRepository(dict):
     @pulumi.getter(name="customRepository")
     def custom_repository(self) -> Optional['outputs.RepositoryRemoteRepositoryConfigPythonRepositoryCustomRepository']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         Structure is documented below.
         """
         return pulumi.get(self, "custom_repository")
@@ -1669,7 +1675,10 @@ class GetRepositoryRemoteRepositoryConfigCommonRepositoryResult(dict):
     def __init__(__self__, *,
                  uri: str):
         """
-        :param str uri: Specific uri to the Artifact Registory repository, e.g. 'projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY'
+        :param str uri: One of:
+               a. Artifact Registry Repository resource, e.g. 'projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY'
+               b. URI to the registry, e.g. '"https://registry-1.docker.io"'
+               c. URI to Artifact Registry Repository, e.g. '"https://REGION-docker.pkg.dev/UPSTREAM_PROJECT_ID/UPSTREAM_REPOSITORY"'
         """
         pulumi.set(__self__, "uri", uri)
 
@@ -1677,7 +1686,10 @@ class GetRepositoryRemoteRepositoryConfigCommonRepositoryResult(dict):
     @pulumi.getter
     def uri(self) -> str:
         """
-        Specific uri to the Artifact Registory repository, e.g. 'projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY'
+        One of:
+        a. Artifact Registry Repository resource, e.g. 'projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY'
+        b. URI to the registry, e.g. '"https://registry-1.docker.io"'
+        c. URI to Artifact Registry Repository, e.g. '"https://REGION-docker.pkg.dev/UPSTREAM_PROJECT_ID/UPSTREAM_REPOSITORY"'
         """
         return pulumi.get(self, "uri")
 
@@ -1688,7 +1700,7 @@ class GetRepositoryRemoteRepositoryConfigDockerRepositoryResult(dict):
                  custom_repositories: Sequence['outputs.GetRepositoryRemoteRepositoryConfigDockerRepositoryCustomRepositoryResult'],
                  public_repository: str):
         """
-        :param Sequence['GetRepositoryRemoteRepositoryConfigDockerRepositoryCustomRepositoryArgs'] custom_repositories: Settings for a remote repository with a custom uri.
+        :param Sequence['GetRepositoryRemoteRepositoryConfigDockerRepositoryCustomRepositoryArgs'] custom_repositories: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         :param str public_repository: Address of the remote repository. Default value: "DOCKER_HUB" Possible values: ["DOCKER_HUB"]
         """
         pulumi.set(__self__, "custom_repositories", custom_repositories)
@@ -1698,7 +1710,7 @@ class GetRepositoryRemoteRepositoryConfigDockerRepositoryResult(dict):
     @pulumi.getter(name="customRepositories")
     def custom_repositories(self) -> Sequence['outputs.GetRepositoryRemoteRepositoryConfigDockerRepositoryCustomRepositoryResult']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         """
         return pulumi.get(self, "custom_repositories")
 
@@ -1735,7 +1747,7 @@ class GetRepositoryRemoteRepositoryConfigMavenRepositoryResult(dict):
                  custom_repositories: Sequence['outputs.GetRepositoryRemoteRepositoryConfigMavenRepositoryCustomRepositoryResult'],
                  public_repository: str):
         """
-        :param Sequence['GetRepositoryRemoteRepositoryConfigMavenRepositoryCustomRepositoryArgs'] custom_repositories: Settings for a remote repository with a custom uri.
+        :param Sequence['GetRepositoryRemoteRepositoryConfigMavenRepositoryCustomRepositoryArgs'] custom_repositories: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         :param str public_repository: Address of the remote repository. Default value: "MAVEN_CENTRAL" Possible values: ["MAVEN_CENTRAL"]
         """
         pulumi.set(__self__, "custom_repositories", custom_repositories)
@@ -1745,7 +1757,7 @@ class GetRepositoryRemoteRepositoryConfigMavenRepositoryResult(dict):
     @pulumi.getter(name="customRepositories")
     def custom_repositories(self) -> Sequence['outputs.GetRepositoryRemoteRepositoryConfigMavenRepositoryCustomRepositoryResult']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         """
         return pulumi.get(self, "custom_repositories")
 
@@ -1782,7 +1794,7 @@ class GetRepositoryRemoteRepositoryConfigNpmRepositoryResult(dict):
                  custom_repositories: Sequence['outputs.GetRepositoryRemoteRepositoryConfigNpmRepositoryCustomRepositoryResult'],
                  public_repository: str):
         """
-        :param Sequence['GetRepositoryRemoteRepositoryConfigNpmRepositoryCustomRepositoryArgs'] custom_repositories: Settings for a remote repository with a custom uri.
+        :param Sequence['GetRepositoryRemoteRepositoryConfigNpmRepositoryCustomRepositoryArgs'] custom_repositories: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         :param str public_repository: Address of the remote repository. Default value: "NPMJS" Possible values: ["NPMJS"]
         """
         pulumi.set(__self__, "custom_repositories", custom_repositories)
@@ -1792,7 +1804,7 @@ class GetRepositoryRemoteRepositoryConfigNpmRepositoryResult(dict):
     @pulumi.getter(name="customRepositories")
     def custom_repositories(self) -> Sequence['outputs.GetRepositoryRemoteRepositoryConfigNpmRepositoryCustomRepositoryResult']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         """
         return pulumi.get(self, "custom_repositories")
 
@@ -1829,7 +1841,7 @@ class GetRepositoryRemoteRepositoryConfigPythonRepositoryResult(dict):
                  custom_repositories: Sequence['outputs.GetRepositoryRemoteRepositoryConfigPythonRepositoryCustomRepositoryResult'],
                  public_repository: str):
         """
-        :param Sequence['GetRepositoryRemoteRepositoryConfigPythonRepositoryCustomRepositoryArgs'] custom_repositories: Settings for a remote repository with a custom uri.
+        :param Sequence['GetRepositoryRemoteRepositoryConfigPythonRepositoryCustomRepositoryArgs'] custom_repositories: [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         :param str public_repository: Address of the remote repository. Default value: "PYPI" Possible values: ["PYPI"]
         """
         pulumi.set(__self__, "custom_repositories", custom_repositories)
@@ -1839,7 +1851,7 @@ class GetRepositoryRemoteRepositoryConfigPythonRepositoryResult(dict):
     @pulumi.getter(name="customRepositories")
     def custom_repositories(self) -> Sequence['outputs.GetRepositoryRemoteRepositoryConfigPythonRepositoryCustomRepositoryResult']:
         """
-        Settings for a remote repository with a custom uri.
+        [Deprecated, please use commonRepository instead] Settings for a remote repository with a custom uri.
         """
         return pulumi.get(self, "custom_repositories")
 

pulumi_gcp/artifactregistry/repository.py

@@ -41,11 +41,11 @@ class RepositoryArgs:
                can be found [here](https://cloud.google.com/artifact-registry/docs/supported-formats).
                You can only create alpha formats if you are a member of the
                [alpha user group](https://cloud.google.com/artifact-registry/docs/supported-formats#alpha-access).
+        :param pulumi.Input[str] repository_id: The last part of the repository name, for example:
+               "repo1"
                
                
                - - -
-        :param pulumi.Input[str] repository_id: The last part of the repository name, for example:
-               "repo1"
         :param pulumi.Input[Sequence[pulumi.Input['RepositoryCleanupPolicyArgs']]] cleanup_policies: Cleanup policies for this repository. Cleanup policies indicate when
                certain package versions can be automatically deleted.
                Map keys are policy IDs supplied by users during policy creation. They must
@@ -68,7 +68,12 @@ class RepositoryArgs:
                
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
-        :param pulumi.Input[str] location: The name of the location this repository is located in.
+        :param pulumi.Input[str] location: The name of the repository's location. In addition to specific regions,
+               special values for multi-region locations are `asia`, `europe`, and `us`.
+               See [here](https://cloud.google.com/artifact-registry/docs/repositories/repo-locations),
+               or use the
+               artifactregistry_get_locations
+               data source for possible values.
         :param pulumi.Input['RepositoryMavenConfigArgs'] maven_config: MavenRepositoryConfig is maven related repository details.
                Provides additional configuration details for repositories of the maven
                format type.
@@ -118,9 +123,6 @@ class RepositoryArgs:
         can be found [here](https://cloud.google.com/artifact-registry/docs/supported-formats).
         You can only create alpha formats if you are a member of the
         [alpha user group](https://cloud.google.com/artifact-registry/docs/supported-formats#alpha-access).
-
-
-        - - -
         """
         return pulumi.get(self, "format")
 
@@ -134,6 +136,9 @@ class RepositoryArgs:
         """
         The last part of the repository name, for example:
         "repo1"
+
+
+        - - -
         """
         return pulumi.get(self, "repository_id")
 
@@ -233,7 +238,12 @@ class RepositoryArgs:
     @pulumi.getter
     def location(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of the location this repository is located in.
+        The name of the repository's location. In addition to specific regions,
+        special values for multi-region locations are `asia`, `europe`, and `us`.
+        See [here](https://cloud.google.com/artifact-registry/docs/repositories/repo-locations),
+        or use the
+        artifactregistry_get_locations
+        data source for possible values.
         """
         return pulumi.get(self, "location")
 
@@ -350,9 +360,6 @@ class _RepositoryState:
                can be found [here](https://cloud.google.com/artifact-registry/docs/supported-formats).
                You can only create alpha formats if you are a member of the
                [alpha user group](https://cloud.google.com/artifact-registry/docs/supported-formats#alpha-access).
-               
-               
-               - - -
         :param pulumi.Input[str] kms_key_name: The Cloud KMS resource name of the customer managed encryption key that’s
                used to encrypt the contents of the Repository. Has the form:
                `projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key`.
@@ -365,7 +372,12 @@ class _RepositoryState:
                
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
-        :param pulumi.Input[str] location: The name of the location this repository is located in.
+        :param pulumi.Input[str] location: The name of the repository's location. In addition to specific regions,
+               special values for multi-region locations are `asia`, `europe`, and `us`.
+               See [here](https://cloud.google.com/artifact-registry/docs/repositories/repo-locations),
+               or use the
+               artifactregistry_get_locations
+               data source for possible values.
         :param pulumi.Input['RepositoryMavenConfigArgs'] maven_config: MavenRepositoryConfig is maven related repository details.
                Provides additional configuration details for repositories of the maven
                format type.
@@ -383,6 +395,9 @@ class _RepositoryState:
                Structure is documented below.
         :param pulumi.Input[str] repository_id: The last part of the repository name, for example:
                "repo1"
+               
+               
+               - - -
         :param pulumi.Input[str] update_time: The time when the repository was last updated.
         :param pulumi.Input['RepositoryVirtualRepositoryConfigArgs'] virtual_repository_config: Configuration specific for a Virtual Repository.
                Structure is documented below.
@@ -512,9 +527,6 @@ class _RepositoryState:
         can be found [here](https://cloud.google.com/artifact-registry/docs/supported-formats).
         You can only create alpha formats if you are a member of the
         [alpha user group](https://cloud.google.com/artifact-registry/docs/supported-formats#alpha-access).
-
-
-        - - -
         """
         return pulumi.get(self, "format")
 
@@ -560,7 +572,12 @@ class _RepositoryState:
     @pulumi.getter
     def location(self) -> Optional[pulumi.Input[str]]:
         """
-        The name of the location this repository is located in.
+        The name of the repository's location. In addition to specific regions,
+        special values for multi-region locations are `asia`, `europe`, and `us`.
+        See [here](https://cloud.google.com/artifact-registry/docs/repositories/repo-locations),
+        or use the
+        artifactregistry_get_locations
+        data source for possible values.
         """
         return pulumi.get(self, "location")
 
@@ -655,6 +672,9 @@ class _RepositoryState:
         """
         The last part of the repository name, for example:
         "repo1"
+
+
+        - - -
         """
         return pulumi.get(self, "repository_id")
 
@@ -731,6 +751,18 @@ class Repository(pulumi.CustomResource):
             description="example docker repository",
             format="DOCKER")
         ```
+        ### Artifact Registry Repository Multi Region
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        my_repo = gcp.artifactregistry.Repository("my-repo",
+            repository_id="my-repository",
+            description="example docker repository",
+            location="us",
+            format="DOCKER")
+        ```
         ### Artifact Registry Repository Docker
 
         ```python
@@ -1143,6 +1175,70 @@ class Repository(pulumi.CustomResource):
                 },
             })
         ```
+        ### Artifact Registry Repository Remote Common Repository With Artifact Registry Uri
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        project = gcp.organizations.get_project()
+        upstream_repo = gcp.artifactregistry.Repository("upstream_repo",
+            location="us-central1",
+            repository_id="example-upstream-repo",
+            description="example upstream repository",
+            format="DOCKER")
+        my_repo = gcp.artifactregistry.Repository("my-repo",
+            location="us-central1",
+            repository_id="example-common-remote",
+            description="example remote common repository with docker upstream",
+            format="DOCKER",
+            mode="REMOTE_REPOSITORY",
+            remote_repository_config={
+                "description": "pull-through cache of another Artifact Registry repository by URL",
+                "common_repository": {
+                    "uri": "https://us-central1-docker.pkg.dev//example-upstream-repo",
+                },
+            })
+        ```
+        ### Artifact Registry Repository Remote Common Repository With Custom Upstream
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        project = gcp.organizations.get_project()
+        example_remote_secret = gcp.secretmanager.Secret("example-remote-secret",
+            secret_id="example-secret",
+            replication={
+                "auto": {},
+            })
+        example_remote_secret_version = gcp.secretmanager.SecretVersion("example-remote-secret_version",
+            secret=example_remote_secret.id,
+            secret_data="remote-password")
+        secret_access = gcp.secretmanager.SecretIamMember("secret-access",
+            secret_id=example_remote_secret.id,
+            role="roles/secretmanager.secretAccessor",
+            member=f"serviceAccount:service-{project.number}@gcp-sa-artifactregistry.iam.gserviceaccount.com")
+        my_repo = gcp.artifactregistry.Repository("my-repo",
+            location="us-central1",
+            repository_id="example-docker-custom-remote",
+            description="example remote custom docker repository with credentials",
+            format="DOCKER",
+            mode="REMOTE_REPOSITORY",
+            remote_repository_config={
+                "description": "custom common docker remote with credentials",
+                "disable_upstream_validation": True,
+                "common_repository": {
+                    "uri": "https://registry-1.docker.io",
+                },
+                "upstream_credentials": {
+                    "username_password_credentials": {
+                        "username": "remote-username",
+                        "password_secret_version": example_remote_secret_version.name,
+                    },
+                },
+            })
+        ```
 
         ## Import
 
@@ -1154,8 +1250,6 @@ class Repository(pulumi.CustomResource):
 
         * `{{location}}/{{repository_id}}`
 
-        * `{{repository_id}}`
-
         When using the `pulumi import` command, Repository can be imported using one of the formats above. For example:
 
         ```sh
@@ -1170,10 +1264,6 @@ class Repository(pulumi.CustomResource):
         $ pulumi import gcp:artifactregistry/repository:Repository default {{location}}/{{repository_id}}
         ```
 
-        ```sh
-        $ pulumi import gcp:artifactregistry/repository:Repository default {{repository_id}}
-        ```
-
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Sequence[pulumi.Input[Union['RepositoryCleanupPolicyArgs', 'RepositoryCleanupPolicyArgsDict']]]] cleanup_policies: Cleanup policies for this repository. Cleanup policies indicate when
@@ -1190,9 +1280,6 @@ class Repository(pulumi.CustomResource):
                can be found [here](https://cloud.google.com/artifact-registry/docs/supported-formats).
                You can only create alpha formats if you are a member of the
                [alpha user group](https://cloud.google.com/artifact-registry/docs/supported-formats#alpha-access).
-               
-               
-               - - -
         :param pulumi.Input[str] kms_key_name: The Cloud KMS resource name of the customer managed encryption key that’s
                used to encrypt the contents of the Repository. Has the form:
                `projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key`.
@@ -1205,7 +1292,12 @@ class Repository(pulumi.CustomResource):
                
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
-        :param pulumi.Input[str] location: The name of the location this repository is located in.
+        :param pulumi.Input[str] location: The name of the repository's location. In addition to specific regions,
+               special values for multi-region locations are `asia`, `europe`, and `us`.
+               See [here](https://cloud.google.com/artifact-registry/docs/repositories/repo-locations),
+               or use the
+               artifactregistry_get_locations
+               data source for possible values.
         :param pulumi.Input[Union['RepositoryMavenConfigArgs', 'RepositoryMavenConfigArgsDict']] maven_config: MavenRepositoryConfig is maven related repository details.
                Provides additional configuration details for repositories of the maven
                format type.
@@ -1219,6 +1311,9 @@ class Repository(pulumi.CustomResource):
                Structure is documented below.
         :param pulumi.Input[str] repository_id: The last part of the repository name, for example:
                "repo1"
+               
+               
+               - - -
         :param pulumi.Input[Union['RepositoryVirtualRepositoryConfigArgs', 'RepositoryVirtualRepositoryConfigArgsDict']] virtual_repository_config: Configuration specific for a Virtual Repository.
                Structure is documented below.
         """
@@ -1251,6 +1346,18 @@ class Repository(pulumi.CustomResource):
             description="example docker repository",
             format="DOCKER")
         ```
+        ### Artifact Registry Repository Multi Region
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        my_repo = gcp.artifactregistry.Repository("my-repo",
+            repository_id="my-repository",
+            description="example docker repository",
+            location="us",
+            format="DOCKER")
+        ```
         ### Artifact Registry Repository Docker
 
         ```python
@@ -1663,6 +1770,70 @@ class Repository(pulumi.CustomResource):
                 },
             })
         ```
+        ### Artifact Registry Repository Remote Common Repository With Artifact Registry Uri
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        project = gcp.organizations.get_project()
+        upstream_repo = gcp.artifactregistry.Repository("upstream_repo",
+            location="us-central1",
+            repository_id="example-upstream-repo",
+            description="example upstream repository",
+            format="DOCKER")
+        my_repo = gcp.artifactregistry.Repository("my-repo",
+            location="us-central1",
+            repository_id="example-common-remote",
+            description="example remote common repository with docker upstream",
+            format="DOCKER",
+            mode="REMOTE_REPOSITORY",
+            remote_repository_config={
+                "description": "pull-through cache of another Artifact Registry repository by URL",
+                "common_repository": {
+                    "uri": "https://us-central1-docker.pkg.dev//example-upstream-repo",
+                },
+            })
+        ```
+        ### Artifact Registry Repository Remote Common Repository With Custom Upstream
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        project = gcp.organizations.get_project()
+        example_remote_secret = gcp.secretmanager.Secret("example-remote-secret",
+            secret_id="example-secret",
+            replication={
+                "auto": {},
+            })
+        example_remote_secret_version = gcp.secretmanager.SecretVersion("example-remote-secret_version",
+            secret=example_remote_secret.id,
+            secret_data="remote-password")
+        secret_access = gcp.secretmanager.SecretIamMember("secret-access",
+            secret_id=example_remote_secret.id,
+            role="roles/secretmanager.secretAccessor",
+            member=f"serviceAccount:service-{project.number}@gcp-sa-artifactregistry.iam.gserviceaccount.com")
+        my_repo = gcp.artifactregistry.Repository("my-repo",
+            location="us-central1",
+            repository_id="example-docker-custom-remote",
+            description="example remote custom docker repository with credentials",
+            format="DOCKER",
+            mode="REMOTE_REPOSITORY",
+            remote_repository_config={
+                "description": "custom common docker remote with credentials",
+                "disable_upstream_validation": True,
+                "common_repository": {
+                    "uri": "https://registry-1.docker.io",
+                },
+                "upstream_credentials": {
+                    "username_password_credentials": {
+                        "username": "remote-username",
+                        "password_secret_version": example_remote_secret_version.name,
+                    },
+                },
+            })
+        ```
 
         ## Import
 
@@ -1674,8 +1845,6 @@ class Repository(pulumi.CustomResource):
 
         * `{{location}}/{{repository_id}}`
 
-        * `{{repository_id}}`
-
         When using the `pulumi import` command, Repository can be imported using one of the formats above. For example:
 
         ```sh
@@ -1690,10 +1859,6 @@ class Repository(pulumi.CustomResource):
         $ pulumi import gcp:artifactregistry/repository:Repository default {{location}}/{{repository_id}}
         ```
 
-        ```sh
-        $ pulumi import gcp:artifactregistry/repository:Repository default {{repository_id}}
-        ```
-
         :param str resource_name: The name of the resource.
         :param RepositoryArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -1809,9 +1974,6 @@ class Repository(pulumi.CustomResource):
                can be found [here](https://cloud.google.com/artifact-registry/docs/supported-formats).
                You can only create alpha formats if you are a member of the
                [alpha user group](https://cloud.google.com/artifact-registry/docs/supported-formats#alpha-access).
-               
-               
-               - - -
         :param pulumi.Input[str] kms_key_name: The Cloud KMS resource name of the customer managed encryption key that’s
                used to encrypt the contents of the Repository. Has the form:
                `projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key`.
@@ -1824,7 +1986,12 @@ class Repository(pulumi.CustomResource):
                
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
-        :param pulumi.Input[str] location: The name of the location this repository is located in.
+        :param pulumi.Input[str] location: The name of the repository's location. In addition to specific regions,
+               special values for multi-region locations are `asia`, `europe`, and `us`.
+               See [here](https://cloud.google.com/artifact-registry/docs/repositories/repo-locations),
+               or use the
+               artifactregistry_get_locations
+               data source for possible values.
         :param pulumi.Input[Union['RepositoryMavenConfigArgs', 'RepositoryMavenConfigArgsDict']] maven_config: MavenRepositoryConfig is maven related repository details.
                Provides additional configuration details for repositories of the maven
                format type.
@@ -1842,6 +2009,9 @@ class Repository(pulumi.CustomResource):
                Structure is documented below.
         :param pulumi.Input[str] repository_id: The last part of the repository name, for example:
                "repo1"
+               
+               
+               - - -
         :param pulumi.Input[str] update_time: The time when the repository was last updated.
         :param pulumi.Input[Union['RepositoryVirtualRepositoryConfigArgs', 'RepositoryVirtualRepositoryConfigArgsDict']] virtual_repository_config: Configuration specific for a Virtual Repository.
                Structure is documented below.
@@ -1933,9 +2103,6 @@ class Repository(pulumi.CustomResource):
         can be found [here](https://cloud.google.com/artifact-registry/docs/supported-formats).
         You can only create alpha formats if you are a member of the
         [alpha user group](https://cloud.google.com/artifact-registry/docs/supported-formats#alpha-access).
-
-
-        - - -
         """
         return pulumi.get(self, "format")
 
@@ -1969,7 +2136,12 @@ class Repository(pulumi.CustomResource):
     @pulumi.getter
     def location(self) -> pulumi.Output[str]:
         """
-        The name of the location this repository is located in.
+        The name of the repository's location. In addition to specific regions,
+        special values for multi-region locations are `asia`, `europe`, and `us`.
+        See [here](https://cloud.google.com/artifact-registry/docs/repositories/repo-locations),
+        or use the
+        artifactregistry_get_locations
+        data source for possible values.
         """
         return pulumi.get(self, "location")
 
@@ -2036,6 +2208,9 @@ class Repository(pulumi.CustomResource):
         """
         The last part of the repository name, for example:
         "repo1"
+
+
+        - - -
         """
         return pulumi.get(self, "repository_id")