diff --git a/.github/.OwlBot.lock.yaml b/.github/.OwlBot.lock.yaml index c701359..b8dcb4a 100644 --- a/.github/.OwlBot.lock.yaml +++ b/.github/.OwlBot.lock.yaml @@ -13,5 +13,4 @@ # limitations under the License. docker: image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest - digest: sha256:c6c965a4bf40c19011b11f87dbc801a66d3a23fbc6704102be064ef31c51f1c3 -# created: 2022-08-09T15:58:56.463048506Z + digest: sha256:993a058718e84a82fda04c3177e58f0a43281a996c7c395e0a56ccc4d6d210d7 diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index 8acb14e..1c4d623 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -21,14 +21,12 @@ export PYTHONUNBUFFERED=1 export PATH="${HOME}/.local/bin:${PATH}" # Install nox -python3 -m pip install --user --upgrade --quiet nox +python3 -m pip install --require-hashes -r .kokoro/requirements.txt python3 -m nox --version # build docs nox -s docs -python3 -m pip install --user gcp-docuploader - # create metadata python3 -m docuploader create-metadata \ --name=$(jq --raw-output '.name // empty' .repo-metadata.json) \ diff --git a/.kokoro/release.sh b/.kokoro/release.sh index 9bbf60e..c6bc164 100755 --- a/.kokoro/release.sh +++ b/.kokoro/release.sh @@ -16,12 +16,9 @@ set -eo pipefail # Start the releasetool reporter -python3 -m pip install gcp-releasetool +python3 -m pip install --require-hashes -r github/python-storage-transfer/.kokoro/requirements.txt python3 -m releasetool publish-reporter-script > /tmp/publisher-script; source /tmp/publisher-script -# Ensure that we have the latest versions of Twine, Wheel, and Setuptools. -python3 -m pip install --upgrade twine wheel setuptools - # Disable buffering, so that the logs stream through. export PYTHONUNBUFFERED=1 diff --git a/.kokoro/requirements.in b/.kokoro/requirements.in new file mode 100644 index 0000000..7718391 --- /dev/null +++ b/.kokoro/requirements.in @@ -0,0 +1,8 @@ +gcp-docuploader +gcp-releasetool +importlib-metadata +typing-extensions +twine +wheel +setuptools +nox \ No newline at end of file diff --git a/.kokoro/requirements.txt b/.kokoro/requirements.txt new file mode 100644 index 0000000..385f2d4 --- /dev/null +++ b/.kokoro/requirements.txt @@ -0,0 +1,472 @@ +# +# This file is autogenerated by pip-compile with python 3.10 +# To update, run: +# +# pip-compile --allow-unsafe --generate-hashes requirements.in +# +argcomplete==2.0.0 \ + --hash=sha256:6372ad78c89d662035101418ae253668445b391755cfe94ea52f1b9d22425b20 \ + --hash=sha256:cffa11ea77999bb0dd27bb25ff6dc142a6796142f68d45b1a26b11f58724561e + # via nox +attrs==22.1.0 \ + --hash=sha256:29adc2665447e5191d0e7c568fde78b21f9672d344281d0c6e1ab085429b22b6 \ + --hash=sha256:86efa402f67bf2df34f51a335487cf46b1ec130d02b8d39fd248abfd30da551c + # via gcp-releasetool +bleach==5.0.1 \ + --hash=sha256:085f7f33c15bd408dd9b17a4ad77c577db66d76203e5984b1bd59baeee948b2a \ + --hash=sha256:0d03255c47eb9bd2f26aa9bb7f2107732e7e8fe195ca2f64709fcf3b0a4a085c + # via readme-renderer +cachetools==5.2.0 \ + --hash=sha256:6a94c6402995a99c3970cc7e4884bb60b4a8639938157eeed436098bf9831757 \ + --hash=sha256:f9f17d2aec496a9aa6b76f53e3b614c965223c061982d434d160f930c698a9db + # via google-auth +certifi==2022.6.15 \ + --hash=sha256:84c85a9078b11105f04f3036a9482ae10e4621616db313fe045dd24743a0820d \ + --hash=sha256:fe86415d55e84719d75f8b69414f6438ac3547d2078ab91b67e779ef69378412 + # via requests +cffi==1.15.1 \ + --hash=sha256:00a9ed42e88df81ffae7a8ab6d9356b371399b91dbdf0c3cb1e84c03a13aceb5 \ + --hash=sha256:03425bdae262c76aad70202debd780501fabeaca237cdfddc008987c0e0f59ef \ + --hash=sha256:04ed324bda3cda42b9b695d51bb7d54b680b9719cfab04227cdd1e04e5de3104 \ + --hash=sha256:0e2642fe3142e4cc4af0799748233ad6da94c62a8bec3a6648bf8ee68b1c7426 \ + --hash=sha256:173379135477dc8cac4bc58f45db08ab45d228b3363adb7af79436135d028405 \ + --hash=sha256:198caafb44239b60e252492445da556afafc7d1e3ab7a1fb3f0584ef6d742375 \ + --hash=sha256:1e74c6b51a9ed6589199c787bf5f9875612ca4a8a0785fb2d4a84429badaf22a \ + --hash=sha256:2012c72d854c2d03e45d06ae57f40d78e5770d252f195b93f581acf3ba44496e \ + --hash=sha256:21157295583fe8943475029ed5abdcf71eb3911894724e360acff1d61c1d54bc \ + --hash=sha256:2470043b93ff09bf8fb1d46d1cb756ce6132c54826661a32d4e4d132e1977adf \ + --hash=sha256:285d29981935eb726a4399badae8f0ffdff4f5050eaa6d0cfc3f64b857b77185 \ + --hash=sha256:30d78fbc8ebf9c92c9b7823ee18eb92f2e6ef79b45ac84db507f52fbe3ec4497 \ + --hash=sha256:320dab6e7cb2eacdf0e658569d2575c4dad258c0fcc794f46215e1e39f90f2c3 \ + --hash=sha256:33ab79603146aace82c2427da5ca6e58f2b3f2fb5da893ceac0c42218a40be35 \ + --hash=sha256:3548db281cd7d2561c9ad9984681c95f7b0e38881201e157833a2342c30d5e8c \ + --hash=sha256:3799aecf2e17cf585d977b780ce79ff0dc9b78d799fc694221ce814c2c19db83 \ + --hash=sha256:39d39875251ca8f612b6f33e6b1195af86d1b3e60086068be9cc053aa4376e21 \ + --hash=sha256:3b926aa83d1edb5aa5b427b4053dc420ec295a08e40911296b9eb1b6170f6cca \ + --hash=sha256:3bcde07039e586f91b45c88f8583ea7cf7a0770df3a1649627bf598332cb6984 \ + --hash=sha256:3d08afd128ddaa624a48cf2b859afef385b720bb4b43df214f85616922e6a5ac \ + --hash=sha256:3eb6971dcff08619f8d91607cfc726518b6fa2a9eba42856be181c6d0d9515fd \ + --hash=sha256:40f4774f5a9d4f5e344f31a32b5096977b5d48560c5592e2f3d2c4374bd543ee \ + --hash=sha256:4289fc34b2f5316fbb762d75362931e351941fa95fa18789191b33fc4cf9504a \ + --hash=sha256:470c103ae716238bbe698d67ad020e1db9d9dba34fa5a899b5e21577e6d52ed2 \ + --hash=sha256:4f2c9f67e9821cad2e5f480bc8d83b8742896f1242dba247911072d4fa94c192 \ + --hash=sha256:50a74364d85fd319352182ef59c5c790484a336f6db772c1a9231f1c3ed0cbd7 \ + --hash=sha256:54a2db7b78338edd780e7ef7f9f6c442500fb0d41a5a4ea24fff1c929d5af585 \ + --hash=sha256:5635bd9cb9731e6d4a1132a498dd34f764034a8ce60cef4f5319c0541159392f \ + --hash=sha256:59c0b02d0a6c384d453fece7566d1c7e6b7bae4fc5874ef2ef46d56776d61c9e \ + --hash=sha256:5d598b938678ebf3c67377cdd45e09d431369c3b1a5b331058c338e201f12b27 \ + --hash=sha256:5df2768244d19ab7f60546d0c7c63ce1581f7af8b5de3eb3004b9b6fc8a9f84b \ + --hash=sha256:5ef34d190326c3b1f822a5b7a45f6c4535e2f47ed06fec77d3d799c450b2651e \ + --hash=sha256:6975a3fac6bc83c4a65c9f9fcab9e47019a11d3d2cf7f3c0d03431bf145a941e \ + --hash=sha256:6c9a799e985904922a4d207a94eae35c78ebae90e128f0c4e521ce339396be9d \ + --hash=sha256:70df4e3b545a17496c9b3f41f5115e69a4f2e77e94e1d2a8e1070bc0c38c8a3c \ + --hash=sha256:7473e861101c9e72452f9bf8acb984947aa1661a7704553a9f6e4baa5ba64415 \ + --hash=sha256:8102eaf27e1e448db915d08afa8b41d6c7ca7a04b7d73af6514df10a3e74bd82 \ + --hash=sha256:87c450779d0914f2861b8526e035c5e6da0a3199d8f1add1a665e1cbc6fc6d02 \ + --hash=sha256:8b7ee99e510d7b66cdb6c593f21c043c248537a32e0bedf02e01e9553a172314 \ + --hash=sha256:91fc98adde3d7881af9b59ed0294046f3806221863722ba7d8d120c575314325 \ + --hash=sha256:94411f22c3985acaec6f83c6df553f2dbe17b698cc7f8ae751ff2237d96b9e3c \ + --hash=sha256:98d85c6a2bef81588d9227dde12db8a7f47f639f4a17c9ae08e773aa9c697bf3 \ + --hash=sha256:9ad5db27f9cabae298d151c85cf2bad1d359a1b9c686a275df03385758e2f914 \ + --hash=sha256:a0b71b1b8fbf2b96e41c4d990244165e2c9be83d54962a9a1d118fd8657d2045 \ + --hash=sha256:a0f100c8912c114ff53e1202d0078b425bee3649ae34d7b070e9697f93c5d52d \ + --hash=sha256:a591fe9e525846e4d154205572a029f653ada1a78b93697f3b5a8f1f2bc055b9 \ + --hash=sha256:a5c84c68147988265e60416b57fc83425a78058853509c1b0629c180094904a5 \ + --hash=sha256:a66d3508133af6e8548451b25058d5812812ec3798c886bf38ed24a98216fab2 \ + --hash=sha256:a8c4917bd7ad33e8eb21e9a5bbba979b49d9a97acb3a803092cbc1133e20343c \ + --hash=sha256:b3bbeb01c2b273cca1e1e0c5df57f12dce9a4dd331b4fa1635b8bec26350bde3 \ + --hash=sha256:cba9d6b9a7d64d4bd46167096fc9d2f835e25d7e4c121fb2ddfc6528fb0413b2 \ + --hash=sha256:cc4d65aeeaa04136a12677d3dd0b1c0c94dc43abac5860ab33cceb42b801c1e8 \ + --hash=sha256:ce4bcc037df4fc5e3d184794f27bdaab018943698f4ca31630bc7f84a7b69c6d \ + --hash=sha256:cec7d9412a9102bdc577382c3929b337320c4c4c4849f2c5cdd14d7368c5562d \ + --hash=sha256:d400bfb9a37b1351253cb402671cea7e89bdecc294e8016a707f6d1d8ac934f9 \ + --hash=sha256:d61f4695e6c866a23a21acab0509af1cdfd2c013cf256bbf5b6b5e2695827162 \ + --hash=sha256:db0fbb9c62743ce59a9ff687eb5f4afbe77e5e8403d6697f7446e5f609976f76 \ + --hash=sha256:dd86c085fae2efd48ac91dd7ccffcfc0571387fe1193d33b6394db7ef31fe2a4 \ + --hash=sha256:e00b098126fd45523dd056d2efba6c5a63b71ffe9f2bbe1a4fe1716e1d0c331e \ + --hash=sha256:e229a521186c75c8ad9490854fd8bbdd9a0c9aa3a524326b55be83b54d4e0ad9 \ + --hash=sha256:e263d77ee3dd201c3a142934a086a4450861778baaeeb45db4591ef65550b0a6 \ + --hash=sha256:ed9cb427ba5504c1dc15ede7d516b84757c3e3d7868ccc85121d9310d27eed0b \ + --hash=sha256:fa6693661a4c91757f4412306191b6dc88c1703f780c8234035eac011922bc01 \ + --hash=sha256:fcd131dd944808b5bdb38e6f5b53013c5aa4f334c5cad0c72742f6eba4b73db0 + # via cryptography +charset-normalizer==2.1.1 \ + --hash=sha256:5a3d016c7c547f69d6f81fb0db9449ce888b418b5b9952cc5e6e66843e9dd845 \ + --hash=sha256:83e9a75d1911279afd89352c68b45348559d1fc0506b054b346651b5e7fee29f + # via requests +click==8.0.4 \ + --hash=sha256:6a7a62563bbfabfda3a38f3023a1db4a35978c0abd76f6c9605ecd6554d6d9b1 \ + --hash=sha256:8458d7b1287c5fb128c90e23381cf99dcde74beaf6c7ff6384ce84d6fe090adb + # via + # gcp-docuploader + # gcp-releasetool +colorlog==6.7.0 \ + --hash=sha256:0d33ca236784a1ba3ff9c532d4964126d8a2c44f1f0cb1d2b0728196f512f662 \ + --hash=sha256:bd94bd21c1e13fac7bd3153f4bc3a7dc0eb0974b8bc2fdf1a989e474f6e582e5 + # via + # gcp-docuploader + # nox +commonmark==0.9.1 \ + --hash=sha256:452f9dc859be7f06631ddcb328b6919c67984aca654e5fefb3914d54691aed60 \ + --hash=sha256:da2f38c92590f83de410ba1a3cbceafbc74fee9def35f9251ba9a971d6d66fd9 + # via rich +cryptography==37.0.4 \ + --hash=sha256:190f82f3e87033821828f60787cfa42bff98404483577b591429ed99bed39d59 \ + --hash=sha256:2be53f9f5505673eeda5f2736bea736c40f051a739bfae2f92d18aed1eb54596 \ + --hash=sha256:30788e070800fec9bbcf9faa71ea6d8068f5136f60029759fd8c3efec3c9dcb3 \ + --hash=sha256:3d41b965b3380f10e4611dbae366f6dc3cefc7c9ac4e8842a806b9672ae9add5 \ + --hash=sha256:4c590ec31550a724ef893c50f9a97a0c14e9c851c85621c5650d699a7b88f7ab \ + --hash=sha256:549153378611c0cca1042f20fd9c5030d37a72f634c9326e225c9f666d472884 \ + --hash=sha256:63f9c17c0e2474ccbebc9302ce2f07b55b3b3fcb211ded18a42d5764f5c10a82 \ + --hash=sha256:6bc95ed67b6741b2607298f9ea4932ff157e570ef456ef7ff0ef4884a134cc4b \ + --hash=sha256:7099a8d55cd49b737ffc99c17de504f2257e3787e02abe6d1a6d136574873441 \ + --hash=sha256:75976c217f10d48a8b5a8de3d70c454c249e4b91851f6838a4e48b8f41eb71aa \ + --hash=sha256:7bc997818309f56c0038a33b8da5c0bfbb3f1f067f315f9abd6fc07ad359398d \ + --hash=sha256:80f49023dd13ba35f7c34072fa17f604d2f19bf0989f292cedf7ab5770b87a0b \ + --hash=sha256:91ce48d35f4e3d3f1d83e29ef4a9267246e6a3be51864a5b7d2247d5086fa99a \ + --hash=sha256:a958c52505c8adf0d3822703078580d2c0456dd1d27fabfb6f76fe63d2971cd6 \ + --hash=sha256:b62439d7cd1222f3da897e9a9fe53bbf5c104fff4d60893ad1355d4c14a24157 \ + --hash=sha256:b7f8dd0d4c1f21759695c05a5ec8536c12f31611541f8904083f3dc582604280 \ + --hash=sha256:d204833f3c8a33bbe11eda63a54b1aad7aa7456ed769a982f21ec599ba5fa282 \ + --hash=sha256:e007f052ed10cc316df59bc90fbb7ff7950d7e2919c9757fd42a2b8ecf8a5f67 \ + --hash=sha256:f2dcb0b3b63afb6df7fd94ec6fbddac81b5492513f7b0436210d390c14d46ee8 \ + --hash=sha256:f721d1885ecae9078c3f6bbe8a88bc0786b6e749bf32ccec1ef2b18929a05046 \ + --hash=sha256:f7a6de3e98771e183645181b3627e2563dcde3ce94a9e42a3f427d2255190327 \ + --hash=sha256:f8c0a6e9e1dd3eb0414ba320f85da6b0dcbd543126e30fcc546e7372a7fbf3b9 + # via + # gcp-releasetool + # secretstorage +distlib==0.3.6 \ + --hash=sha256:14bad2d9b04d3a36127ac97f30b12a19268f211063d8f8ee4f47108896e11b46 \ + --hash=sha256:f35c4b692542ca110de7ef0bea44d73981caeb34ca0b9b6b2e6d7790dda8f80e + # via virtualenv +docutils==0.19 \ + --hash=sha256:33995a6753c30b7f577febfc2c50411fec6aac7f7ffeb7c4cfe5991072dcf9e6 \ + --hash=sha256:5e1de4d849fee02c63b040a4a3fd567f4ab104defd8a5511fbbc24a8a017efbc + # via readme-renderer +filelock==3.8.0 \ + --hash=sha256:55447caa666f2198c5b6b13a26d2084d26fa5b115c00d065664b2124680c4edc \ + --hash=sha256:617eb4e5eedc82fc5f47b6d61e4d11cb837c56cb4544e39081099fa17ad109d4 + # via virtualenv +gcp-docuploader==0.6.3 \ + --hash=sha256:ba8c9d76b3bbac54b0311c503a373b00edc2dc02d6d54ea9507045adb8e870f7 \ + --hash=sha256:c0f5aaa82ce1854a386197e4e359b120ad6d4e57ae2c812fce42219a3288026b + # via -r requirements.in +gcp-releasetool==1.8.7 \ + --hash=sha256:3d2a67c9db39322194afb3b427e9cb0476ce8f2a04033695f0aeb63979fc2b37 \ + --hash=sha256:5e4d28f66e90780d77f3ecf1e9155852b0c3b13cbccb08ab07e66b2357c8da8d + # via -r requirements.in +google-api-core==2.8.2 \ + --hash=sha256:06f7244c640322b508b125903bb5701bebabce8832f85aba9335ec00b3d02edc \ + --hash=sha256:93c6a91ccac79079ac6bbf8b74ee75db970cc899278b97d53bc012f35908cf50 + # via + # google-cloud-core + # google-cloud-storage +google-auth==2.11.0 \ + --hash=sha256:be62acaae38d0049c21ca90f27a23847245c9f161ff54ede13af2cb6afecbac9 \ + --hash=sha256:ed65ecf9f681832298e29328e1ef0a3676e3732b2e56f41532d45f70a22de0fb + # via + # gcp-releasetool + # google-api-core + # google-cloud-core + # google-cloud-storage +google-cloud-core==2.3.2 \ + --hash=sha256:8417acf6466be2fa85123441696c4badda48db314c607cf1e5d543fa8bdc22fe \ + --hash=sha256:b9529ee7047fd8d4bf4a2182de619154240df17fbe60ead399078c1ae152af9a + # via google-cloud-storage +google-cloud-storage==2.5.0 \ + --hash=sha256:19a26c66c317ce542cea0830b7e787e8dac2588b6bfa4d3fd3b871ba16305ab0 \ + --hash=sha256:382f34b91de2212e3c2e7b40ec079d27ee2e3dbbae99b75b1bcd8c63063ce235 + # via gcp-docuploader +google-crc32c==1.3.0 \ + --hash=sha256:04e7c220798a72fd0f08242bc8d7a05986b2a08a0573396187fd32c1dcdd58b3 \ + --hash=sha256:05340b60bf05b574159e9bd940152a47d38af3fb43803ffe71f11d704b7696a6 \ + --hash=sha256:12674a4c3b56b706153a358eaa1018c4137a5a04635b92b4652440d3d7386206 \ + --hash=sha256:127f9cc3ac41b6a859bd9dc4321097b1a4f6aa7fdf71b4f9227b9e3ebffb4422 \ + --hash=sha256:13af315c3a0eec8bb8b8d80b8b128cb3fcd17d7e4edafc39647846345a3f003a \ + --hash=sha256:1926fd8de0acb9d15ee757175ce7242e235482a783cd4ec711cc999fc103c24e \ + --hash=sha256:226f2f9b8e128a6ca6a9af9b9e8384f7b53a801907425c9a292553a3a7218ce0 \ + --hash=sha256:276de6273eb074a35bc598f8efbc00c7869c5cf2e29c90748fccc8c898c244df \ + --hash=sha256:318f73f5484b5671f0c7f5f63741ab020a599504ed81d209b5c7129ee4667407 \ + --hash=sha256:3bbce1be3687bbfebe29abdb7631b83e6b25da3f4e1856a1611eb21854b689ea \ + --hash=sha256:42ae4781333e331a1743445931b08ebdad73e188fd554259e772556fc4937c48 \ + --hash=sha256:58be56ae0529c664cc04a9c76e68bb92b091e0194d6e3c50bea7e0f266f73713 \ + --hash=sha256:5da2c81575cc3ccf05d9830f9e8d3c70954819ca9a63828210498c0774fda1a3 \ + --hash=sha256:6311853aa2bba4064d0c28ca54e7b50c4d48e3de04f6770f6c60ebda1e975267 \ + --hash=sha256:650e2917660e696041ab3dcd7abac160b4121cd9a484c08406f24c5964099829 \ + --hash=sha256:6a4db36f9721fdf391646685ecffa404eb986cbe007a3289499020daf72e88a2 \ + --hash=sha256:779cbf1ce375b96111db98fca913c1f5ec11b1d870e529b1dc7354b2681a8c3a \ + --hash=sha256:7f6fe42536d9dcd3e2ffb9d3053f5d05221ae3bbcefbe472bdf2c71c793e3183 \ + --hash=sha256:891f712ce54e0d631370e1f4997b3f182f3368179198efc30d477c75d1f44942 \ + --hash=sha256:95c68a4b9b7828ba0428f8f7e3109c5d476ca44996ed9a5f8aac6269296e2d59 \ + --hash=sha256:96a8918a78d5d64e07c8ea4ed2bc44354e3f93f46a4866a40e8db934e4c0d74b \ + --hash=sha256:9c3cf890c3c0ecfe1510a452a165431b5831e24160c5fcf2071f0f85ca5a47cd \ + --hash=sha256:9f58099ad7affc0754ae42e6d87443299f15d739b0ce03c76f515153a5cda06c \ + --hash=sha256:a0b9e622c3b2b8d0ce32f77eba617ab0d6768b82836391e4f8f9e2074582bf02 \ + --hash=sha256:a7f9cbea4245ee36190f85fe1814e2d7b1e5f2186381b082f5d59f99b7f11328 \ + --hash=sha256:bab4aebd525218bab4ee615786c4581952eadc16b1ff031813a2fd51f0cc7b08 \ + --hash=sha256:c124b8c8779bf2d35d9b721e52d4adb41c9bfbde45e6a3f25f0820caa9aba73f \ + --hash=sha256:c9da0a39b53d2fab3e5467329ed50e951eb91386e9d0d5b12daf593973c3b168 \ + --hash=sha256:ca60076c388728d3b6ac3846842474f4250c91efbfe5afa872d3ffd69dd4b318 \ + --hash=sha256:cb6994fff247987c66a8a4e550ef374671c2b82e3c0d2115e689d21e511a652d \ + --hash=sha256:d1c1d6236feab51200272d79b3d3e0f12cf2cbb12b208c835b175a21efdb0a73 \ + --hash=sha256:dd7760a88a8d3d705ff562aa93f8445ead54f58fd482e4f9e2bafb7e177375d4 \ + --hash=sha256:dda4d8a3bb0b50f540f6ff4b6033f3a74e8bf0bd5320b70fab2c03e512a62812 \ + --hash=sha256:e0f1ff55dde0ebcfbef027edc21f71c205845585fffe30d4ec4979416613e9b3 \ + --hash=sha256:e7a539b9be7b9c00f11ef16b55486141bc2cdb0c54762f84e3c6fc091917436d \ + --hash=sha256:eb0b14523758e37802f27b7f8cd973f5f3d33be7613952c0df904b68c4842f0e \ + --hash=sha256:ed447680ff21c14aaceb6a9f99a5f639f583ccfe4ce1a5e1d48eb41c3d6b3217 \ + --hash=sha256:f52a4ad2568314ee713715b1e2d79ab55fab11e8b304fd1462ff5cccf4264b3e \ + --hash=sha256:fbd60c6aaa07c31d7754edbc2334aef50601b7f1ada67a96eb1eb57c7c72378f \ + --hash=sha256:fc28e0db232c62ca0c3600884933178f0825c99be4474cdd645e378a10588125 \ + --hash=sha256:fe31de3002e7b08eb20823b3735b97c86c5926dd0581c7710a680b418a8709d4 \ + --hash=sha256:fec221a051150eeddfdfcff162e6db92c65ecf46cb0f7bb1bf812a1520ec026b \ + --hash=sha256:ff71073ebf0e42258a42a0b34f2c09ec384977e7f6808999102eedd5b49920e3 + # via google-resumable-media +google-resumable-media==2.3.3 \ + --hash=sha256:27c52620bd364d1c8116eaac4ea2afcbfb81ae9139fb3199652fcac1724bfb6c \ + --hash=sha256:5b52774ea7a829a8cdaa8bd2d4c3d4bc660c91b30857ab2668d0eb830f4ea8c5 + # via google-cloud-storage +googleapis-common-protos==1.56.4 \ + --hash=sha256:8eb2cbc91b69feaf23e32452a7ae60e791e09967d81d4fcc7fc388182d1bd394 \ + --hash=sha256:c25873c47279387cfdcbdafa36149887901d36202cb645a0e4f29686bf6e4417 + # via google-api-core +idna==3.3 \ + --hash=sha256:84d9dd047ffa80596e0f246e2eab0b391788b0503584e8945f2368256d2735ff \ + --hash=sha256:9d643ff0a55b762d5cdb124b8eaa99c66322e2157b69160bc32796e824360e6d + # via requests +importlib-metadata==4.12.0 \ + --hash=sha256:637245b8bab2b6502fcbc752cc4b7a6f6243bb02b31c5c26156ad103d3d45670 \ + --hash=sha256:7401a975809ea1fdc658c3aa4f78cc2195a0e019c5cbc4c06122884e9ae80c23 + # via + # -r requirements.in + # twine +jaraco-classes==3.2.2 \ + --hash=sha256:6745f113b0b588239ceb49532aa09c3ebb947433ce311ef2f8e3ad64ebb74594 \ + --hash=sha256:e6ef6fd3fcf4579a7a019d87d1e56a883f4e4c35cfe925f86731abc58804e647 + # via keyring +jeepney==0.8.0 \ + --hash=sha256:5efe48d255973902f6badc3ce55e2aa6c5c3b3bc642059ef3a91247bcfcc5806 \ + --hash=sha256:c0a454ad016ca575060802ee4d590dd912e35c122fa04e70306de3d076cce755 + # via + # keyring + # secretstorage +jinja2==3.1.2 \ + --hash=sha256:31351a702a408a9e7595a8fc6150fc3f43bb6bf7e319770cbc0db9df9437e852 \ + --hash=sha256:6088930bfe239f0e6710546ab9c19c9ef35e29792895fed6e6e31a023a182a61 + # via gcp-releasetool +keyring==23.9.0 \ + --hash=sha256:4c32a31174faaee48f43a7e2c7e9c3216ec5e95acf22a2bebfb4a1d05056ee44 \ + --hash=sha256:98f060ec95ada2ab910c195a2d4317be6ef87936a766b239c46aa3c7aac4f0db + # via + # gcp-releasetool + # twine +markupsafe==2.1.1 \ + --hash=sha256:0212a68688482dc52b2d45013df70d169f542b7394fc744c02a57374a4207003 \ + --hash=sha256:089cf3dbf0cd6c100f02945abeb18484bd1ee57a079aefd52cffd17fba910b88 \ + --hash=sha256:10c1bfff05d95783da83491be968e8fe789263689c02724e0c691933c52994f5 \ + --hash=sha256:33b74d289bd2f5e527beadcaa3f401e0df0a89927c1559c8566c066fa4248ab7 \ + --hash=sha256:3799351e2336dc91ea70b034983ee71cf2f9533cdff7c14c90ea126bfd95d65a \ + --hash=sha256:3ce11ee3f23f79dbd06fb3d63e2f6af7b12db1d46932fe7bd8afa259a5996603 \ + --hash=sha256:421be9fbf0ffe9ffd7a378aafebbf6f4602d564d34be190fc19a193232fd12b1 \ + --hash=sha256:43093fb83d8343aac0b1baa75516da6092f58f41200907ef92448ecab8825135 \ + --hash=sha256:46d00d6cfecdde84d40e572d63735ef81423ad31184100411e6e3388d405e247 \ + --hash=sha256:4a33dea2b688b3190ee12bd7cfa29d39c9ed176bda40bfa11099a3ce5d3a7ac6 \ + --hash=sha256:4b9fe39a2ccc108a4accc2676e77da025ce383c108593d65cc909add5c3bd601 \ + --hash=sha256:56442863ed2b06d19c37f94d999035e15ee982988920e12a5b4ba29b62ad1f77 \ + --hash=sha256:671cd1187ed5e62818414afe79ed29da836dde67166a9fac6d435873c44fdd02 \ + --hash=sha256:694deca8d702d5db21ec83983ce0bb4b26a578e71fbdbd4fdcd387daa90e4d5e \ + --hash=sha256:6a074d34ee7a5ce3effbc526b7083ec9731bb3cbf921bbe1d3005d4d2bdb3a63 \ + --hash=sha256:6d0072fea50feec76a4c418096652f2c3238eaa014b2f94aeb1d56a66b41403f \ + --hash=sha256:6fbf47b5d3728c6aea2abb0589b5d30459e369baa772e0f37a0320185e87c980 \ + --hash=sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b \ + --hash=sha256:86b1f75c4e7c2ac2ccdaec2b9022845dbb81880ca318bb7a0a01fbf7813e3812 \ + --hash=sha256:8dc1c72a69aa7e082593c4a203dcf94ddb74bb5c8a731e4e1eb68d031e8498ff \ + --hash=sha256:8e3dcf21f367459434c18e71b2a9532d96547aef8a871872a5bd69a715c15f96 \ + --hash=sha256:8e576a51ad59e4bfaac456023a78f6b5e6e7651dcd383bcc3e18d06f9b55d6d1 \ + --hash=sha256:96e37a3dc86e80bf81758c152fe66dbf60ed5eca3d26305edf01892257049925 \ + --hash=sha256:97a68e6ada378df82bc9f16b800ab77cbf4b2fada0081794318520138c088e4a \ + --hash=sha256:99a2a507ed3ac881b975a2976d59f38c19386d128e7a9a18b7df6fff1fd4c1d6 \ + --hash=sha256:a49907dd8420c5685cfa064a1335b6754b74541bbb3706c259c02ed65b644b3e \ + --hash=sha256:b09bf97215625a311f669476f44b8b318b075847b49316d3e28c08e41a7a573f \ + --hash=sha256:b7bd98b796e2b6553da7225aeb61f447f80a1ca64f41d83612e6139ca5213aa4 \ + --hash=sha256:b87db4360013327109564f0e591bd2a3b318547bcef31b468a92ee504d07ae4f \ + --hash=sha256:bcb3ed405ed3222f9904899563d6fc492ff75cce56cba05e32eff40e6acbeaa3 \ + --hash=sha256:d4306c36ca495956b6d568d276ac11fdd9c30a36f1b6eb928070dc5360b22e1c \ + --hash=sha256:d5ee4f386140395a2c818d149221149c54849dfcfcb9f1debfe07a8b8bd63f9a \ + --hash=sha256:dda30ba7e87fbbb7eab1ec9f58678558fd9a6b8b853530e176eabd064da81417 \ + --hash=sha256:e04e26803c9c3851c931eac40c695602c6295b8d432cbe78609649ad9bd2da8a \ + --hash=sha256:e1c0b87e09fa55a220f058d1d49d3fb8df88fbfab58558f1198e08c1e1de842a \ + --hash=sha256:e72591e9ecd94d7feb70c1cbd7be7b3ebea3f548870aa91e2732960fa4d57a37 \ + --hash=sha256:e8c843bbcda3a2f1e3c2ab25913c80a3c5376cd00c6e8c4a86a89a28c8dc5452 \ + --hash=sha256:efc1913fd2ca4f334418481c7e595c00aad186563bbc1ec76067848c7ca0a933 \ + --hash=sha256:f121a1420d4e173a5d96e47e9a0c0dcff965afdf1626d28de1460815f7c4ee7a \ + --hash=sha256:fc7b548b17d238737688817ab67deebb30e8073c95749d55538ed473130ec0c7 + # via jinja2 +more-itertools==8.14.0 \ + --hash=sha256:1bc4f91ee5b1b31ac7ceacc17c09befe6a40a503907baf9c839c229b5095cfd2 \ + --hash=sha256:c09443cd3d5438b8dafccd867a6bc1cb0894389e90cb53d227456b0b0bccb750 + # via jaraco-classes +nox==2022.8.7 \ + --hash=sha256:1b894940551dc5c389f9271d197ca5d655d40bdc6ccf93ed6880e4042760a34b \ + --hash=sha256:96cca88779e08282a699d672258ec01eb7c792d35bbbf538c723172bce23212c + # via -r requirements.in +packaging==21.3 \ + --hash=sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb \ + --hash=sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522 + # via + # gcp-releasetool + # nox +pkginfo==1.8.3 \ + --hash=sha256:848865108ec99d4901b2f7e84058b6e7660aae8ae10164e015a6dcf5b242a594 \ + --hash=sha256:a84da4318dd86f870a9447a8c98340aa06216bfc6f2b7bdc4b8766984ae1867c + # via twine +platformdirs==2.5.2 \ + --hash=sha256:027d8e83a2d7de06bbac4e5ef7e023c02b863d7ea5d079477e722bb41ab25788 \ + --hash=sha256:58c8abb07dcb441e6ee4b11d8df0ac856038f944ab98b7be6b27b2a3c7feef19 + # via virtualenv +protobuf==3.20.1 \ + --hash=sha256:06059eb6953ff01e56a25cd02cca1a9649a75a7e65397b5b9b4e929ed71d10cf \ + --hash=sha256:097c5d8a9808302fb0da7e20edf0b8d4703274d140fd25c5edabddcde43e081f \ + --hash=sha256:284f86a6207c897542d7e956eb243a36bb8f9564c1742b253462386e96c6b78f \ + --hash=sha256:32ca378605b41fd180dfe4e14d3226386d8d1b002ab31c969c366549e66a2bb7 \ + --hash=sha256:3cc797c9d15d7689ed507b165cd05913acb992d78b379f6014e013f9ecb20996 \ + --hash=sha256:62f1b5c4cd6c5402b4e2d63804ba49a327e0c386c99b1675c8a0fefda23b2067 \ + --hash=sha256:69ccfdf3657ba59569c64295b7d51325f91af586f8d5793b734260dfe2e94e2c \ + --hash=sha256:6f50601512a3d23625d8a85b1638d914a0970f17920ff39cec63aaef80a93fb7 \ + --hash=sha256:7403941f6d0992d40161aa8bb23e12575637008a5a02283a930addc0508982f9 \ + --hash=sha256:755f3aee41354ae395e104d62119cb223339a8f3276a0cd009ffabfcdd46bb0c \ + --hash=sha256:77053d28427a29987ca9caf7b72ccafee011257561259faba8dd308fda9a8739 \ + --hash=sha256:7e371f10abe57cee5021797126c93479f59fccc9693dafd6bd5633ab67808a91 \ + --hash=sha256:9016d01c91e8e625141d24ec1b20fed584703e527d28512aa8c8707f105a683c \ + --hash=sha256:9be73ad47579abc26c12024239d3540e6b765182a91dbc88e23658ab71767153 \ + --hash=sha256:adc31566d027f45efe3f44eeb5b1f329da43891634d61c75a5944e9be6dd42c9 \ + --hash=sha256:adfc6cf69c7f8c50fd24c793964eef18f0ac321315439d94945820612849c388 \ + --hash=sha256:af0ebadc74e281a517141daad9d0f2c5d93ab78e9d455113719a45a49da9db4e \ + --hash=sha256:cb29edb9eab15742d791e1025dd7b6a8f6fcb53802ad2f6e3adcb102051063ab \ + --hash=sha256:cd68be2559e2a3b84f517fb029ee611546f7812b1fdd0aa2ecc9bc6ec0e4fdde \ + --hash=sha256:cdee09140e1cd184ba9324ec1df410e7147242b94b5f8b0c64fc89e38a8ba531 \ + --hash=sha256:db977c4ca738dd9ce508557d4fce0f5aebd105e158c725beec86feb1f6bc20d8 \ + --hash=sha256:dd5789b2948ca702c17027c84c2accb552fc30f4622a98ab5c51fcfe8c50d3e7 \ + --hash=sha256:e250a42f15bf9d5b09fe1b293bdba2801cd520a9f5ea2d7fb7536d4441811d20 \ + --hash=sha256:ff8d8fa42675249bb456f5db06c00de6c2f4c27a065955917b28c4f15978b9c3 + # via + # gcp-docuploader + # gcp-releasetool + # google-api-core +py==1.11.0 \ + --hash=sha256:51c75c4126074b472f746a24399ad32f6053d1b34b68d2fa41e558e6f4a98719 \ + --hash=sha256:607c53218732647dff4acdfcd50cb62615cedf612e72d1724fb1a0cc6405b378 + # via nox +pyasn1==0.4.8 \ + --hash=sha256:39c7e2ec30515947ff4e87fb6f456dfc6e84857d34be479c9d4a4ba4bf46aa5d \ + --hash=sha256:aef77c9fb94a3ac588e87841208bdec464471d9871bd5050a287cc9a475cd0ba + # via + # pyasn1-modules + # rsa +pyasn1-modules==0.2.8 \ + --hash=sha256:905f84c712230b2c592c19470d3ca8d552de726050d1d1716282a1f6146be65e \ + --hash=sha256:a50b808ffeb97cb3601dd25981f6b016cbb3d31fbf57a8b8a87428e6158d0c74 + # via google-auth +pycparser==2.21 \ + --hash=sha256:8ee45429555515e1f6b185e78100aea234072576aa43ab53aefcae078162fca9 \ + --hash=sha256:e644fdec12f7872f86c58ff790da456218b10f863970249516d60a5eaca77206 + # via cffi +pygments==2.13.0 \ + --hash=sha256:56a8508ae95f98e2b9bdf93a6be5ae3f7d8af858b43e02c5a2ff083726be40c1 \ + --hash=sha256:f643f331ab57ba3c9d89212ee4a2dabc6e94f117cf4eefde99a0574720d14c42 + # via + # readme-renderer + # rich +pyjwt==2.4.0 \ + --hash=sha256:72d1d253f32dbd4f5c88eaf1fdc62f3a19f676ccbadb9dbc5d07e951b2b26daf \ + --hash=sha256:d42908208c699b3b973cbeb01a969ba6a96c821eefb1c5bfe4c390c01d67abba + # via gcp-releasetool +pyparsing==3.0.9 \ + --hash=sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb \ + --hash=sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc + # via packaging +pyperclip==1.8.2 \ + --hash=sha256:105254a8b04934f0bc84e9c24eb360a591aaf6535c9def5f29d92af107a9bf57 + # via gcp-releasetool +python-dateutil==2.8.2 \ + --hash=sha256:0123cacc1627ae19ddf3c27a5de5bd67ee4586fbdd6440d9748f8abb483d3e86 \ + --hash=sha256:961d03dc3453ebbc59dbdea9e4e11c5651520a876d0f4db161e8674aae935da9 + # via gcp-releasetool +readme-renderer==37.0 \ + --hash=sha256:07b7ea234e03e58f77cc222e206e6abb8f4c0435becce5104794ee591f9301c5 \ + --hash=sha256:9fa416704703e509eeb900696751c908ddeb2011319d93700d8f18baff887a69 + # via twine +requests==2.28.1 \ + --hash=sha256:7c5599b102feddaa661c826c56ab4fee28bfd17f5abca1ebbe3e7f19d7c97983 \ + --hash=sha256:8fefa2a1a1365bf5520aac41836fbee479da67864514bdb821f31ce07ce65349 + # via + # gcp-releasetool + # google-api-core + # google-cloud-storage + # requests-toolbelt + # twine +requests-toolbelt==0.9.1 \ + --hash=sha256:380606e1d10dc85c3bd47bf5a6095f815ec007be7a8b69c878507068df059e6f \ + --hash=sha256:968089d4584ad4ad7c171454f0a5c6dac23971e9472521ea3b6d49d610aa6fc0 + # via twine +rfc3986==2.0.0 \ + --hash=sha256:50b1502b60e289cb37883f3dfd34532b8873c7de9f49bb546641ce9cbd256ebd \ + --hash=sha256:97aacf9dbd4bfd829baad6e6309fa6573aaf1be3f6fa735c8ab05e46cecb261c + # via twine +rich==12.5.1 \ + --hash=sha256:2eb4e6894cde1e017976d2975ac210ef515d7548bc595ba20e195fb9628acdeb \ + --hash=sha256:63a5c5ce3673d3d5fbbf23cd87e11ab84b6b451436f1b7f19ec54b6bc36ed7ca + # via twine +rsa==4.9 \ + --hash=sha256:90260d9058e514786967344d0ef75fa8727eed8a7d2e43ce9f4bcf1b536174f7 \ + --hash=sha256:e38464a49c6c85d7f1351b0126661487a7e0a14a50f1675ec50eb34d4f20ef21 + # via google-auth +secretstorage==3.3.3 \ + --hash=sha256:2403533ef369eca6d2ba81718576c5e0f564d5cca1b58f73a8b23e7d4eeebd77 \ + --hash=sha256:f356e6628222568e3af06f2eba8df495efa13b3b63081dafd4f7d9a7b7bc9f99 + # via keyring +six==1.16.0 \ + --hash=sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926 \ + --hash=sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254 + # via + # bleach + # gcp-docuploader + # google-auth + # python-dateutil +twine==4.0.1 \ + --hash=sha256:42026c18e394eac3e06693ee52010baa5313e4811d5a11050e7d48436cf41b9e \ + --hash=sha256:96b1cf12f7ae611a4a40b6ae8e9570215daff0611828f5fe1f37a16255ab24a0 + # via -r requirements.in +typing-extensions==4.3.0 \ + --hash=sha256:25642c956049920a5aa49edcdd6ab1e06d7e5d467fc00e0506c44ac86fbfca02 \ + --hash=sha256:e6d2677a32f47fc7eb2795db1dd15c1f34eff616bcaf2cfb5e997f854fa1c4a6 + # via -r requirements.in +urllib3==1.26.12 \ + --hash=sha256:3fa96cf423e6987997fc326ae8df396db2a8b7c667747d47ddd8ecba91f4a74e \ + --hash=sha256:b930dd878d5a8afb066a637fbb35144fe7901e3b209d1cd4f524bd0e9deee997 + # via + # requests + # twine +virtualenv==20.16.4 \ + --hash=sha256:014f766e4134d0008dcaa1f95bafa0fb0f575795d07cae50b1bee514185d6782 \ + --hash=sha256:035ed57acce4ac35c82c9d8802202b0e71adac011a511ff650cbcf9635006a22 + # via nox +webencodings==0.5.1 \ + --hash=sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78 \ + --hash=sha256:b36a1c245f2d304965eb4e0a82848379241dc04b865afcc4aab16748587e1923 + # via bleach +wheel==0.37.1 \ + --hash=sha256:4bdcd7d840138086126cd09254dc6195fb4fc6f01c050a1d7236f2630db1d22a \ + --hash=sha256:e9a504e793efbca1b8e0e9cb979a249cf4a0a7b5b8c9e8b65a5e39d49529c1c4 + # via -r requirements.in +zipp==3.8.1 \ + --hash=sha256:05b45f1ee8f807d0cc928485ca40a07cb491cf092ff587c0df9cb1fd154848d2 \ + --hash=sha256:47c40d7fe183a6f21403a199b3e4192cca5774656965b0a4988ad2f8feb5f009 + # via importlib-metadata + +# The following packages are considered to be unsafe in a requirements file: +setuptools==65.2.0 \ + --hash=sha256:7f4bc85450898a09f76ebf28b72fa25bc7111f6c7d665d514a60bba9c75ef2a9 \ + --hash=sha256:a3ca5857c89f82f5c9410e8508cb32f4872a3bafd4aa7ae122a24ca33bccc750 + # via -r requirements.in diff --git a/CHANGELOG.md b/CHANGELOG.md index bc15489..cecd36a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,14 @@ # Changelog +## [1.5.0](https://github.com/googleapis/python-storage-transfer/compare/v1.4.1...v1.5.0) (2022-09-12) + + +### Features + +* add AWS S3 compatible data source ([7bbaafb](https://github.com/googleapis/python-storage-transfer/commit/7bbaafb7a3b16aef6993656a8e49e4a35db9a479)) +* Add default retry configuration ([#123](https://github.com/googleapis/python-storage-transfer/issues/123)) ([7bbaafb](https://github.com/googleapis/python-storage-transfer/commit/7bbaafb7a3b16aef6993656a8e49e4a35db9a479)) +* add DeleteTransferJob operation ([7bbaafb](https://github.com/googleapis/python-storage-transfer/commit/7bbaafb7a3b16aef6993656a8e49e4a35db9a479)) + ## [1.4.1](https://github.com/googleapis/python-storage-transfer/compare/v1.4.0...v1.4.1) (2022-08-11) diff --git a/google/cloud/storage_transfer/__init__.py b/google/cloud/storage_transfer/__init__.py index 3c2dcf1..e1bf564 100644 --- a/google/cloud/storage_transfer/__init__.py +++ b/google/cloud/storage_transfer/__init__.py @@ -24,6 +24,7 @@ CreateAgentPoolRequest, CreateTransferJobRequest, DeleteAgentPoolRequest, + DeleteTransferJobRequest, GetAgentPoolRequest, GetGoogleServiceAccountRequest, GetTransferJobRequest, @@ -40,6 +41,7 @@ from google.cloud.storage_transfer_v1.types.transfer_types import ( AgentPool, AwsAccessKey, + AwsS3CompatibleData, AwsS3Data, AzureBlobStorageData, AzureCredentials, @@ -53,6 +55,7 @@ NotificationConfig, ObjectConditions, PosixFilesystem, + S3CompatibleMetadata, Schedule, TransferCounters, TransferJob, @@ -68,6 +71,7 @@ "CreateAgentPoolRequest", "CreateTransferJobRequest", "DeleteAgentPoolRequest", + "DeleteTransferJobRequest", "GetAgentPoolRequest", "GetGoogleServiceAccountRequest", "GetTransferJobRequest", @@ -82,6 +86,7 @@ "UpdateTransferJobRequest", "AgentPool", "AwsAccessKey", + "AwsS3CompatibleData", "AwsS3Data", "AzureBlobStorageData", "AzureCredentials", @@ -95,6 +100,7 @@ "NotificationConfig", "ObjectConditions", "PosixFilesystem", + "S3CompatibleMetadata", "Schedule", "TransferCounters", "TransferJob", diff --git a/google/cloud/storage_transfer_v1/__init__.py b/google/cloud/storage_transfer_v1/__init__.py index 08408fb..66be688 100644 --- a/google/cloud/storage_transfer_v1/__init__.py +++ b/google/cloud/storage_transfer_v1/__init__.py @@ -22,6 +22,7 @@ CreateAgentPoolRequest, CreateTransferJobRequest, DeleteAgentPoolRequest, + DeleteTransferJobRequest, GetAgentPoolRequest, GetGoogleServiceAccountRequest, GetTransferJobRequest, @@ -38,6 +39,7 @@ from .types.transfer_types import ( AgentPool, AwsAccessKey, + AwsS3CompatibleData, AwsS3Data, AzureBlobStorageData, AzureCredentials, @@ -51,6 +53,7 @@ NotificationConfig, ObjectConditions, PosixFilesystem, + S3CompatibleMetadata, Schedule, TransferCounters, TransferJob, @@ -64,12 +67,14 @@ "StorageTransferServiceAsyncClient", "AgentPool", "AwsAccessKey", + "AwsS3CompatibleData", "AwsS3Data", "AzureBlobStorageData", "AzureCredentials", "CreateAgentPoolRequest", "CreateTransferJobRequest", "DeleteAgentPoolRequest", + "DeleteTransferJobRequest", "ErrorLogEntry", "ErrorSummary", "GcsData", @@ -90,6 +95,7 @@ "PosixFilesystem", "ResumeTransferOperationRequest", "RunTransferJobRequest", + "S3CompatibleMetadata", "Schedule", "StorageTransferServiceClient", "TransferCounters", diff --git a/google/cloud/storage_transfer_v1/gapic_metadata.json b/google/cloud/storage_transfer_v1/gapic_metadata.json index 6e937e7..c9f0fb7 100644 --- a/google/cloud/storage_transfer_v1/gapic_metadata.json +++ b/google/cloud/storage_transfer_v1/gapic_metadata.json @@ -25,6 +25,11 @@ "delete_agent_pool" ] }, + "DeleteTransferJob": { + "methods": [ + "delete_transfer_job" + ] + }, "GetAgentPool": { "methods": [ "get_agent_pool" @@ -95,6 +100,11 @@ "delete_agent_pool" ] }, + "DeleteTransferJob": { + "methods": [ + "delete_transfer_job" + ] + }, "GetAgentPool": { "methods": [ "get_agent_pool" diff --git a/google/cloud/storage_transfer_v1/services/storage_transfer_service/async_client.py b/google/cloud/storage_transfer_v1/services/storage_transfer_service/async_client.py index 81f91e8..837a1b8 100644 --- a/google/cloud/storage_transfer_v1/services/storage_transfer_service/async_client.py +++ b/google/cloud/storage_transfer_v1/services/storage_transfer_service/async_client.py @@ -238,6 +238,13 @@ async def get_google_service_account( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_get_google_service_account(): @@ -311,6 +318,13 @@ async def create_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_create_transfer_job(): @@ -350,7 +364,7 @@ async def sample_create_transfer_job(): # and friendly error handling. rpc = gapic_v1.method_async.wrap_method( self._client._transport.create_transfer_job, - default_timeout=None, + default_timeout=60.0, client_info=DEFAULT_CLIENT_INFO, ) @@ -387,6 +401,13 @@ async def update_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_update_transfer_job(): @@ -461,6 +482,13 @@ async def get_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_get_transfer_job(): @@ -535,6 +563,13 @@ async def list_transfer_jobs( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_list_transfer_jobs(): @@ -615,6 +650,13 @@ async def pause_transfer_operation( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_pause_transfer_operation(): @@ -676,6 +718,13 @@ async def resume_transfer_operation( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_resume_transfer_operation(): @@ -741,6 +790,13 @@ async def run_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_run_transfer_job(): @@ -824,6 +880,76 @@ async def sample_run_transfer_job(): # Done; return the response. return response + async def delete_transfer_job( + self, + request: Union[transfer.DeleteTransferJobRequest, dict] = None, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> None: + r"""Deletes a transfer job. Deleting a transfer job sets its status + to + [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED]. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import storage_transfer_v1 + + async def sample_delete_transfer_job(): + # Create a client + client = storage_transfer_v1.StorageTransferServiceAsyncClient() + + # Initialize request argument(s) + request = storage_transfer_v1.DeleteTransferJobRequest( + job_name="job_name_value", + project_id="project_id_value", + ) + + # Make the request + await client.delete_transfer_job(request=request) + + Args: + request (Union[google.cloud.storage_transfer_v1.types.DeleteTransferJobRequest, dict]): + The request object. Request passed to DeleteTransferJob. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + # Create or coerce a protobuf request object. + request = transfer.DeleteTransferJobRequest(request) + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = gapic_v1.method_async.wrap_method( + self._client._transport.delete_transfer_job, + default_timeout=None, + client_info=DEFAULT_CLIENT_INFO, + ) + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("job_name", request.job_name),)), + ) + + # Send the request. + await rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + async def create_agent_pool( self, request: Union[transfer.CreateAgentPoolRequest, dict] = None, @@ -839,6 +965,13 @@ async def create_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_create_agent_pool(): @@ -971,6 +1104,13 @@ async def update_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_update_agent_pool(): @@ -1094,6 +1234,13 @@ async def get_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_get_agent_pool(): @@ -1187,6 +1334,13 @@ async def list_agent_pools( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_list_agent_pools(): @@ -1296,6 +1450,13 @@ async def delete_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 async def sample_delete_agent_pool(): diff --git a/google/cloud/storage_transfer_v1/services/storage_transfer_service/client.py b/google/cloud/storage_transfer_v1/services/storage_transfer_service/client.py index fa2e3b0..bae15e5 100644 --- a/google/cloud/storage_transfer_v1/services/storage_transfer_service/client.py +++ b/google/cloud/storage_transfer_v1/services/storage_transfer_service/client.py @@ -455,6 +455,13 @@ def get_google_service_account( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_get_google_service_account(): @@ -531,6 +538,13 @@ def create_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_create_transfer_job(): @@ -608,6 +622,13 @@ def update_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_update_transfer_job(): @@ -683,6 +704,13 @@ def get_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_get_transfer_job(): @@ -758,6 +786,13 @@ def list_transfer_jobs( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_list_transfer_jobs(): @@ -839,6 +874,13 @@ def pause_transfer_operation( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_pause_transfer_operation(): @@ -901,6 +943,13 @@ def resume_transfer_operation( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_resume_transfer_operation(): @@ -969,6 +1018,13 @@ def run_transfer_job( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_run_transfer_job(): @@ -1053,6 +1109,77 @@ def sample_run_transfer_job(): # Done; return the response. return response + def delete_transfer_job( + self, + request: Union[transfer.DeleteTransferJobRequest, dict] = None, + *, + retry: OptionalRetry = gapic_v1.method.DEFAULT, + timeout: float = None, + metadata: Sequence[Tuple[str, str]] = (), + ) -> None: + r"""Deletes a transfer job. Deleting a transfer job sets its status + to + [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED]. + + .. code-block:: python + + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html + from google.cloud import storage_transfer_v1 + + def sample_delete_transfer_job(): + # Create a client + client = storage_transfer_v1.StorageTransferServiceClient() + + # Initialize request argument(s) + request = storage_transfer_v1.DeleteTransferJobRequest( + job_name="job_name_value", + project_id="project_id_value", + ) + + # Make the request + client.delete_transfer_job(request=request) + + Args: + request (Union[google.cloud.storage_transfer_v1.types.DeleteTransferJobRequest, dict]): + The request object. Request passed to DeleteTransferJob. + retry (google.api_core.retry.Retry): Designation of what errors, if any, + should be retried. + timeout (float): The timeout for this request. + metadata (Sequence[Tuple[str, str]]): Strings which should be + sent along with the request as metadata. + """ + # Create or coerce a protobuf request object. + # Minor optimization to avoid making a copy if the user passes + # in a transfer.DeleteTransferJobRequest. + # There's no risk of modifying the input as we've already verified + # there are no flattened fields. + if not isinstance(request, transfer.DeleteTransferJobRequest): + request = transfer.DeleteTransferJobRequest(request) + + # Wrap the RPC method; this adds retry and timeout information, + # and friendly error handling. + rpc = self._transport._wrapped_methods[self._transport.delete_transfer_job] + + # Certain fields should be provided within the metadata header; + # add these here. + metadata = tuple(metadata) + ( + gapic_v1.routing_header.to_grpc_metadata((("job_name", request.job_name),)), + ) + + # Send the request. + rpc( + request, + retry=retry, + timeout=timeout, + metadata=metadata, + ) + def create_agent_pool( self, request: Union[transfer.CreateAgentPoolRequest, dict] = None, @@ -1068,6 +1195,13 @@ def create_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_create_agent_pool(): @@ -1200,6 +1334,13 @@ def update_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_update_agent_pool(): @@ -1323,6 +1464,13 @@ def get_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_get_agent_pool(): @@ -1416,6 +1564,13 @@ def list_agent_pools( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_list_agent_pools(): @@ -1525,6 +1680,13 @@ def delete_agent_pool( .. code-block:: python + # This snippet has been automatically generated and should be regarded as a + # code template only. + # It will require modifications to work: + # - It may require correct/in-range values for request initialization. + # - It may require specifying regional endpoints when creating the service + # client as shown in: + # https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 def sample_delete_agent_pool(): diff --git a/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/base.py b/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/base.py index 1c96153..320b3ab 100644 --- a/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/base.py +++ b/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/base.py @@ -136,7 +136,7 @@ def _prep_wrapped_messages(self, client_info): ), self.create_transfer_job: gapic_v1.method.wrap_method( self.create_transfer_job, - default_timeout=None, + default_timeout=60.0, client_info=client_info, ), self.update_transfer_job: gapic_v1.method.wrap_method( @@ -169,6 +169,11 @@ def _prep_wrapped_messages(self, client_info): default_timeout=None, client_info=client_info, ), + self.delete_transfer_job: gapic_v1.method.wrap_method( + self.delete_transfer_job, + default_timeout=None, + client_info=client_info, + ), self.create_agent_pool: gapic_v1.method.wrap_method( self.create_agent_pool, default_timeout=None, @@ -288,6 +293,15 @@ def run_transfer_job( ]: raise NotImplementedError() + @property + def delete_transfer_job( + self, + ) -> Callable[ + [transfer.DeleteTransferJobRequest], + Union[empty_pb2.Empty, Awaitable[empty_pb2.Empty]], + ]: + raise NotImplementedError() + @property def create_agent_pool( self, diff --git a/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc.py b/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc.py index b7d4fa3..3697bd7 100644 --- a/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc.py +++ b/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc.py @@ -482,6 +482,34 @@ def run_transfer_job( ) return self._stubs["run_transfer_job"] + @property + def delete_transfer_job( + self, + ) -> Callable[[transfer.DeleteTransferJobRequest], empty_pb2.Empty]: + r"""Return a callable for the delete transfer job method over gRPC. + + Deletes a transfer job. Deleting a transfer job sets its status + to + [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED]. + + Returns: + Callable[[~.DeleteTransferJobRequest], + ~.Empty]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "delete_transfer_job" not in self._stubs: + self._stubs["delete_transfer_job"] = self.grpc_channel.unary_unary( + "/google.storagetransfer.v1.StorageTransferService/DeleteTransferJob", + request_serializer=transfer.DeleteTransferJobRequest.serialize, + response_deserializer=empty_pb2.Empty.FromString, + ) + return self._stubs["delete_transfer_job"] + @property def create_agent_pool( self, diff --git a/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc_asyncio.py b/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc_asyncio.py index 84121b8..fe4889e 100644 --- a/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc_asyncio.py +++ b/google/cloud/storage_transfer_v1/services/storage_transfer_service/transports/grpc_asyncio.py @@ -498,6 +498,34 @@ def run_transfer_job( ) return self._stubs["run_transfer_job"] + @property + def delete_transfer_job( + self, + ) -> Callable[[transfer.DeleteTransferJobRequest], Awaitable[empty_pb2.Empty]]: + r"""Return a callable for the delete transfer job method over gRPC. + + Deletes a transfer job. Deleting a transfer job sets its status + to + [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED]. + + Returns: + Callable[[~.DeleteTransferJobRequest], + Awaitable[~.Empty]]: + A function that, when called, will call the underlying RPC + on the server. + """ + # Generate a "stub function" on-the-fly which will actually make + # the request. + # gRPC handles serialization and deserialization, so we just need + # to pass in the functions for each. + if "delete_transfer_job" not in self._stubs: + self._stubs["delete_transfer_job"] = self.grpc_channel.unary_unary( + "/google.storagetransfer.v1.StorageTransferService/DeleteTransferJob", + request_serializer=transfer.DeleteTransferJobRequest.serialize, + response_deserializer=empty_pb2.Empty.FromString, + ) + return self._stubs["delete_transfer_job"] + @property def create_agent_pool( self, diff --git a/google/cloud/storage_transfer_v1/types/__init__.py b/google/cloud/storage_transfer_v1/types/__init__.py index 4c98d26..eb8455c 100644 --- a/google/cloud/storage_transfer_v1/types/__init__.py +++ b/google/cloud/storage_transfer_v1/types/__init__.py @@ -17,6 +17,7 @@ CreateAgentPoolRequest, CreateTransferJobRequest, DeleteAgentPoolRequest, + DeleteTransferJobRequest, GetAgentPoolRequest, GetGoogleServiceAccountRequest, GetTransferJobRequest, @@ -33,6 +34,7 @@ from .transfer_types import ( AgentPool, AwsAccessKey, + AwsS3CompatibleData, AwsS3Data, AzureBlobStorageData, AzureCredentials, @@ -46,6 +48,7 @@ NotificationConfig, ObjectConditions, PosixFilesystem, + S3CompatibleMetadata, Schedule, TransferCounters, TransferJob, @@ -59,6 +62,7 @@ "CreateAgentPoolRequest", "CreateTransferJobRequest", "DeleteAgentPoolRequest", + "DeleteTransferJobRequest", "GetAgentPoolRequest", "GetGoogleServiceAccountRequest", "GetTransferJobRequest", @@ -73,6 +77,7 @@ "UpdateTransferJobRequest", "AgentPool", "AwsAccessKey", + "AwsS3CompatibleData", "AwsS3Data", "AzureBlobStorageData", "AzureCredentials", @@ -86,6 +91,7 @@ "NotificationConfig", "ObjectConditions", "PosixFilesystem", + "S3CompatibleMetadata", "Schedule", "TransferCounters", "TransferJob", diff --git a/google/cloud/storage_transfer_v1/types/transfer.py b/google/cloud/storage_transfer_v1/types/transfer.py index 4bc4973..7b40eff 100644 --- a/google/cloud/storage_transfer_v1/types/transfer.py +++ b/google/cloud/storage_transfer_v1/types/transfer.py @@ -25,6 +25,7 @@ "CreateTransferJobRequest", "UpdateTransferJobRequest", "GetTransferJobRequest", + "DeleteTransferJobRequest", "ListTransferJobsRequest", "ListTransferJobsResponse", "PauseTransferOperationRequest", @@ -93,7 +94,7 @@ class UpdateTransferJobRequest(proto.Message): [INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]. Updating a job status to [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED] - requires ``storagetransfer.jobs.delete`` permissions. + requires ``storagetransfer.jobs.delete`` permission. update_transfer_job_field_mask (google.protobuf.field_mask_pb2.FieldMask): The field mask of the fields in ``transferJob`` that are to be updated in this request. Fields in ``transferJob`` that @@ -151,6 +152,27 @@ class GetTransferJobRequest(proto.Message): ) +class DeleteTransferJobRequest(proto.Message): + r"""Request passed to DeleteTransferJob. + + Attributes: + job_name (str): + Required. The job to delete. + project_id (str): + Required. The ID of the Google Cloud project + that owns the job. + """ + + job_name = proto.Field( + proto.STRING, + number=1, + ) + project_id = proto.Field( + proto.STRING, + number=2, + ) + + class ListTransferJobsRequest(proto.Message): r"""``projectId``, ``jobNames``, and ``jobStatuses`` are query parameters that can be specified when listing transfer jobs. diff --git a/google/cloud/storage_transfer_v1/types/transfer_types.py b/google/cloud/storage_transfer_v1/types/transfer_types.py index dcc33d9..6381250 100644 --- a/google/cloud/storage_transfer_v1/types/transfer_types.py +++ b/google/cloud/storage_transfer_v1/types/transfer_types.py @@ -32,6 +32,8 @@ "AzureBlobStorageData", "HttpData", "PosixFilesystem", + "AwsS3CompatibleData", + "S3CompatibleMetadata", "AgentPool", "TransferOptions", "TransferSpec", @@ -486,6 +488,130 @@ class PosixFilesystem(proto.Message): ) +class AwsS3CompatibleData(proto.Message): + r"""An AwsS3CompatibleData resource. + + .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields + + Attributes: + bucket_name (str): + Required. Specifies the name of the bucket. + path (str): + Specifies the root path to transfer objects. + Must be an empty string or full path name that + ends with a '/'. This field is treated as an + object prefix. As such, it should generally not + begin with a '/'. + endpoint (str): + Required. Specifies the endpoint of the + storage service. + region (str): + Specifies the region to sign requests with. + This can be left blank if requests should be + signed with an empty region. + s3_metadata (google.cloud.storage_transfer_v1.types.S3CompatibleMetadata): + A S3 compatible metadata. + + This field is a member of `oneof`_ ``data_provider``. + """ + + bucket_name = proto.Field( + proto.STRING, + number=1, + ) + path = proto.Field( + proto.STRING, + number=2, + ) + endpoint = proto.Field( + proto.STRING, + number=3, + ) + region = proto.Field( + proto.STRING, + number=5, + ) + s3_metadata = proto.Field( + proto.MESSAGE, + number=4, + oneof="data_provider", + message="S3CompatibleMetadata", + ) + + +class S3CompatibleMetadata(proto.Message): + r"""S3CompatibleMetadata contains the metadata fields that apply + to the basic types of S3-compatible data providers. + + Attributes: + auth_method (google.cloud.storage_transfer_v1.types.S3CompatibleMetadata.AuthMethod): + Specifies the authentication and + authorization method used by the storage + service. When not specified, Transfer Service + will attempt to determine right auth method to + use. + request_model (google.cloud.storage_transfer_v1.types.S3CompatibleMetadata.RequestModel): + Specifies the API request model used to call the storage + service. When not specified, the default value of + RequestModel REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used. + protocol (google.cloud.storage_transfer_v1.types.S3CompatibleMetadata.NetworkProtocol): + Specifies the network protocol of the agent. When not + specified, the default value of NetworkProtocol + NETWORK_PROTOCOL_HTTPS is used. + list_api (google.cloud.storage_transfer_v1.types.S3CompatibleMetadata.ListApi): + The Listing API to use for discovering + objects. When not specified, Transfer Service + will attempt to determine the right API to use. + """ + + class AuthMethod(proto.Enum): + r"""The authentication and authorization method used by the + storage service. + """ + AUTH_METHOD_UNSPECIFIED = 0 + AUTH_METHOD_AWS_SIGNATURE_V4 = 1 + AUTH_METHOD_AWS_SIGNATURE_V2 = 2 + + class RequestModel(proto.Enum): + r"""The request model of the API.""" + REQUEST_MODEL_UNSPECIFIED = 0 + REQUEST_MODEL_VIRTUAL_HOSTED_STYLE = 1 + REQUEST_MODEL_PATH_STYLE = 2 + + class NetworkProtocol(proto.Enum): + r"""The agent network protocol to access the storage service.""" + NETWORK_PROTOCOL_UNSPECIFIED = 0 + NETWORK_PROTOCOL_HTTPS = 1 + NETWORK_PROTOCOL_HTTP = 2 + + class ListApi(proto.Enum): + r"""The Listing API to use for discovering objects.""" + LIST_API_UNSPECIFIED = 0 + LIST_OBJECTS_V2 = 1 + LIST_OBJECTS = 2 + + auth_method = proto.Field( + proto.ENUM, + number=1, + enum=AuthMethod, + ) + request_model = proto.Field( + proto.ENUM, + number=2, + enum=RequestModel, + ) + protocol = proto.Field( + proto.ENUM, + number=3, + enum=NetworkProtocol, + ) + list_api = proto.Field( + proto.ENUM, + number=4, + enum=ListApi, + ) + + class AgentPool(proto.Message): r"""Represents an On-Premises Agent pool. @@ -576,11 +702,11 @@ class TransferOptions(proto.Message): are mutually exclusive. overwrite_when (google.cloud.storage_transfer_v1.types.TransferOptions.OverwriteWhen): When to overwrite objects that already exist in the sink. If - not set overwrite behavior is determined by + not set, overwrite behavior is determined by [overwrite_objects_already_existing_in_sink][google.storagetransfer.v1.TransferOptions.overwrite_objects_already_existing_in_sink]. metadata_options (google.cloud.storage_transfer_v1.types.MetadataOptions): Represents the selected metadata options for - a transfer job. This feature is in Preview. + a transfer job. """ class OverwriteWhen(proto.Enum): @@ -654,6 +780,10 @@ class TransferSpec(proto.Message): azure_blob_storage_data_source (google.cloud.storage_transfer_v1.types.AzureBlobStorageData): An Azure Blob Storage data source. + This field is a member of `oneof`_ ``data_source``. + aws_s3_compatible_data_source (google.cloud.storage_transfer_v1.types.AwsS3CompatibleData): + An AWS S3 compatible data source. + This field is a member of `oneof`_ ``data_source``. gcs_intermediate_data_location (google.cloud.storage_transfer_v1.types.GcsData): Cloud Storage intermediate data location. @@ -729,6 +859,12 @@ class TransferSpec(proto.Message): oneof="data_source", message="AzureBlobStorageData", ) + aws_s3_compatible_data_source = proto.Field( + proto.MESSAGE, + number=19, + oneof="data_source", + message="AwsS3CompatibleData", + ) gcs_intermediate_data_location = proto.Field( proto.MESSAGE, number=16, diff --git a/mypy.ini b/mypy.ini index 4505b48..574c5ae 100644 --- a/mypy.ini +++ b/mypy.ini @@ -1,3 +1,3 @@ [mypy] -python_version = 3.6 +python_version = 3.7 namespace_packages = True diff --git a/noxfile.py b/noxfile.py index cc39f3b..ffe9f35 100644 --- a/noxfile.py +++ b/noxfile.py @@ -189,7 +189,9 @@ def unit(session): def install_systemtest_dependencies(session, *constraints): # Use pre-release gRPC for system tests. - session.install("--pre", "grpcio") + # Exclude version 1.49.0rc1 which has a known issue. + # See https://github.com/grpc/grpc/pull/30642 + session.install("--pre", "grpcio!=1.49.0rc1") session.install(*SYSTEM_TEST_STANDARD_DEPENDENCIES, *constraints) @@ -369,7 +371,8 @@ def prerelease_deps(session): # dependency of grpc "six", "googleapis-common-protos", - "grpcio", + # Exclude version 1.49.0rc1 which has a known issue. See https://github.com/grpc/grpc/pull/30642 + "grpcio!=1.49.0rc1", "grpcio-status", "google-api-core", "proto-plus", diff --git a/renovate.json b/renovate.json index c21036d..39b2a0e 100644 --- a/renovate.json +++ b/renovate.json @@ -5,7 +5,7 @@ ":preserveSemverRanges", ":disableDependencyDashboard" ], - "ignorePaths": [".pre-commit-config.yaml"], + "ignorePaths": [".pre-commit-config.yaml", ".kokoro/requirements.txt", "setup.py"], "pip_requirements": { "fileMatch": ["requirements-test.txt", "samples/[\\S/]*constraints.txt", "samples/[\\S/]*constraints-test.txt"] } diff --git a/samples/generated_samples/snippet_metadata_storage transfer_v1.json b/samples/generated_samples/snippet_metadata_storage transfer_v1.json index 37bfae1..35c81f7 100644 --- a/samples/generated_samples/snippet_metadata_storage transfer_v1.json +++ b/samples/generated_samples/snippet_metadata_storage transfer_v1.json @@ -67,33 +67,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_CreateAgentPool_async", "segments": [ { - "end": 49, + "end": 56, "start": 27, "type": "FULL" }, { - "end": 49, + "end": 56, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 43, - "start": 34, + "end": 50, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 46, - "start": 44, + "end": 53, + "start": 51, "type": "REQUEST_EXECUTION" }, { - "end": 50, - "start": 47, + "end": 57, + "start": 54, "type": "RESPONSE_HANDLING" } ], @@ -155,33 +155,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_CreateAgentPool_sync", "segments": [ { - "end": 49, + "end": 56, "start": 27, "type": "FULL" }, { - "end": 49, + "end": 56, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 43, - "start": 34, + "end": 50, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 46, - "start": 44, + "end": 53, + "start": 51, "type": "REQUEST_EXECUTION" }, { - "end": 50, - "start": 47, + "end": 57, + "start": 54, "type": "RESPONSE_HANDLING" } ], @@ -232,33 +232,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_CreateTransferJob_async", "segments": [ { - "end": 43, + "end": 50, "start": 27, "type": "FULL" }, { - "end": 43, + "end": 50, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 37, - "start": 34, + "end": 44, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 40, - "start": 38, + "end": 47, + "start": 45, "type": "REQUEST_EXECUTION" }, { - "end": 44, - "start": 41, + "end": 51, + "start": 48, "type": "RESPONSE_HANDLING" } ], @@ -308,33 +308,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_CreateTransferJob_sync", "segments": [ { - "end": 43, + "end": 50, "start": 27, "type": "FULL" }, { - "end": 43, + "end": 50, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 37, - "start": 34, + "end": 44, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 40, - "start": 38, + "end": 47, + "start": 45, "type": "REQUEST_EXECUTION" }, { - "end": 44, - "start": 41, + "end": 51, + "start": 48, "type": "RESPONSE_HANDLING" } ], @@ -388,31 +388,31 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_DeleteAgentPool_async", "segments": [ { - "end": 42, + "end": 49, "start": 27, "type": "FULL" }, { - "end": 42, + "end": 49, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "start": 39, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 43, + "end": 50, "type": "RESPONSE_HANDLING" } ], @@ -465,36 +465,183 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_DeleteAgentPool_sync", "segments": [ { - "end": 42, + "end": 49, "start": 27, "type": "FULL" }, { - "end": 42, + "end": 49, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "start": 39, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 43, + "end": 50, "type": "RESPONSE_HANDLING" } ], "title": "storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_sync.py" }, + { + "canonical": true, + "clientMethod": { + "async": true, + "client": { + "fullName": "google.cloud.storage_transfer_v1.StorageTransferServiceAsyncClient", + "shortName": "StorageTransferServiceAsyncClient" + }, + "fullName": "google.cloud.storage_transfer_v1.StorageTransferServiceAsyncClient.delete_transfer_job", + "method": { + "fullName": "google.storagetransfer.v1.StorageTransferService.DeleteTransferJob", + "service": { + "fullName": "google.storagetransfer.v1.StorageTransferService", + "shortName": "StorageTransferService" + }, + "shortName": "DeleteTransferJob" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.storage_transfer_v1.types.DeleteTransferJobRequest" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "shortName": "delete_transfer_job" + }, + "description": "Sample for DeleteTransferJob", + "file": "storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_async.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "storagetransfer_v1_generated_StorageTransferService_DeleteTransferJob_async", + "segments": [ + { + "end": 50, + "start": 27, + "type": "FULL" + }, + { + "end": 50, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 46, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "start": 47, + "type": "REQUEST_EXECUTION" + }, + { + "end": 51, + "type": "RESPONSE_HANDLING" + } + ], + "title": "storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_async.py" + }, + { + "canonical": true, + "clientMethod": { + "client": { + "fullName": "google.cloud.storage_transfer_v1.StorageTransferServiceClient", + "shortName": "StorageTransferServiceClient" + }, + "fullName": "google.cloud.storage_transfer_v1.StorageTransferServiceClient.delete_transfer_job", + "method": { + "fullName": "google.storagetransfer.v1.StorageTransferService.DeleteTransferJob", + "service": { + "fullName": "google.storagetransfer.v1.StorageTransferService", + "shortName": "StorageTransferService" + }, + "shortName": "DeleteTransferJob" + }, + "parameters": [ + { + "name": "request", + "type": "google.cloud.storage_transfer_v1.types.DeleteTransferJobRequest" + }, + { + "name": "retry", + "type": "google.api_core.retry.Retry" + }, + { + "name": "timeout", + "type": "float" + }, + { + "name": "metadata", + "type": "Sequence[Tuple[str, str]" + } + ], + "shortName": "delete_transfer_job" + }, + "description": "Sample for DeleteTransferJob", + "file": "storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_sync.py", + "language": "PYTHON", + "origin": "API_DEFINITION", + "regionTag": "storagetransfer_v1_generated_StorageTransferService_DeleteTransferJob_sync", + "segments": [ + { + "end": 50, + "start": 27, + "type": "FULL" + }, + { + "end": 50, + "start": 27, + "type": "SHORT" + }, + { + "end": 40, + "start": 38, + "type": "CLIENT_INITIALIZATION" + }, + { + "end": 46, + "start": 41, + "type": "REQUEST_INITIALIZATION" + }, + { + "start": 47, + "type": "REQUEST_EXECUTION" + }, + { + "end": 51, + "type": "RESPONSE_HANDLING" + } + ], + "title": "storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_sync.py" + }, { "canonical": true, "clientMethod": { @@ -544,33 +691,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_GetAgentPool_async", "segments": [ { - "end": 44, + "end": 51, "start": 27, "type": "FULL" }, { - "end": 44, + "end": 51, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 45, - "start": 42, + "end": 52, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -624,33 +771,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_GetAgentPool_sync", "segments": [ { - "end": 44, + "end": 51, "start": 27, "type": "FULL" }, { - "end": 44, + "end": 51, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 45, - "start": 42, + "end": 52, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -701,33 +848,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_GetGoogleServiceAccount_async", "segments": [ { - "end": 44, + "end": 51, "start": 27, "type": "FULL" }, { - "end": 44, + "end": 51, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 45, - "start": 42, + "end": 52, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -777,33 +924,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_GetGoogleServiceAccount_sync", "segments": [ { - "end": 44, + "end": 51, "start": 27, "type": "FULL" }, { - "end": 44, + "end": 51, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 45, - "start": 42, + "end": 52, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -854,33 +1001,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_GetTransferJob_async", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 39, - "start": 34, + "end": 46, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 42, - "start": 40, + "end": 49, + "start": 47, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 43, + "end": 53, + "start": 50, "type": "RESPONSE_HANDLING" } ], @@ -930,33 +1077,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_GetTransferJob_sync", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 39, - "start": 34, + "end": 46, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 42, - "start": 40, + "end": 49, + "start": 47, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 43, + "end": 53, + "start": 50, "type": "RESPONSE_HANDLING" } ], @@ -1011,33 +1158,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_ListAgentPools_async", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 42, + "end": 53, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -1091,33 +1238,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_ListAgentPools_sync", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 42, + "end": 53, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -1168,33 +1315,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_ListTransferJobs_async", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 42, + "end": 53, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -1244,33 +1391,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_ListTransferJobs_sync", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 41, - "start": 39, + "end": 48, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 42, + "end": 53, + "start": 49, "type": "RESPONSE_HANDLING" } ], @@ -1320,31 +1467,31 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_PauseTransferOperation_async", "segments": [ { - "end": 42, + "end": 49, "start": 27, "type": "FULL" }, { - "end": 42, + "end": 49, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "start": 39, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 43, + "end": 50, "type": "RESPONSE_HANDLING" } ], @@ -1393,31 +1540,31 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_PauseTransferOperation_sync", "segments": [ { - "end": 42, + "end": 49, "start": 27, "type": "FULL" }, { - "end": 42, + "end": 49, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "start": 39, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 43, + "end": 50, "type": "RESPONSE_HANDLING" } ], @@ -1467,31 +1614,31 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_ResumeTransferOperation_async", "segments": [ { - "end": 42, + "end": 49, "start": 27, "type": "FULL" }, { - "end": 42, + "end": 49, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "start": 39, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 43, + "end": 50, "type": "RESPONSE_HANDLING" } ], @@ -1540,31 +1687,31 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_ResumeTransferOperation_sync", "segments": [ { - "end": 42, + "end": 49, "start": 27, "type": "FULL" }, { - "end": 42, + "end": 49, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 38, - "start": 34, + "end": 45, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "start": 39, + "start": 46, "type": "REQUEST_EXECUTION" }, { - "end": 43, + "end": 50, "type": "RESPONSE_HANDLING" } ], @@ -1615,33 +1762,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_RunTransferJob_async", "segments": [ { - "end": 49, + "end": 56, "start": 27, "type": "FULL" }, { - "end": 49, + "end": 56, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 39, - "start": 34, + "end": 46, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 46, - "start": 40, + "end": 53, + "start": 47, "type": "REQUEST_EXECUTION" }, { - "end": 50, - "start": 47, + "end": 57, + "start": 54, "type": "RESPONSE_HANDLING" } ], @@ -1691,33 +1838,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_RunTransferJob_sync", "segments": [ { - "end": 49, + "end": 56, "start": 27, "type": "FULL" }, { - "end": 49, + "end": 56, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 39, - "start": 34, + "end": 46, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 46, - "start": 40, + "end": 53, + "start": 47, "type": "REQUEST_EXECUTION" }, { - "end": 50, - "start": 47, + "end": 57, + "start": 54, "type": "RESPONSE_HANDLING" } ], @@ -1776,33 +1923,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_UpdateAgentPool_async", "segments": [ { - "end": 47, + "end": 54, "start": 27, "type": "FULL" }, { - "end": 47, + "end": 54, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 41, - "start": 34, + "end": 48, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 44, - "start": 42, + "end": 51, + "start": 49, "type": "REQUEST_EXECUTION" }, { - "end": 48, - "start": 45, + "end": 55, + "start": 52, "type": "RESPONSE_HANDLING" } ], @@ -1860,33 +2007,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_UpdateAgentPool_sync", "segments": [ { - "end": 47, + "end": 54, "start": 27, "type": "FULL" }, { - "end": 47, + "end": 54, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 41, - "start": 34, + "end": 48, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 44, - "start": 42, + "end": 51, + "start": 49, "type": "REQUEST_EXECUTION" }, { - "end": 48, - "start": 45, + "end": 55, + "start": 52, "type": "RESPONSE_HANDLING" } ], @@ -1937,33 +2084,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_UpdateTransferJob_async", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 39, - "start": 34, + "end": 46, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 42, - "start": 40, + "end": 49, + "start": 47, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 43, + "end": 53, + "start": 50, "type": "RESPONSE_HANDLING" } ], @@ -2013,33 +2160,33 @@ "regionTag": "storagetransfer_v1_generated_StorageTransferService_UpdateTransferJob_sync", "segments": [ { - "end": 45, + "end": 52, "start": 27, "type": "FULL" }, { - "end": 45, + "end": 52, "start": 27, "type": "SHORT" }, { - "end": 33, - "start": 31, + "end": 40, + "start": 38, "type": "CLIENT_INITIALIZATION" }, { - "end": 39, - "start": 34, + "end": 46, + "start": 41, "type": "REQUEST_INITIALIZATION" }, { - "end": 42, - "start": 40, + "end": 49, + "start": 47, "type": "REQUEST_EXECUTION" }, { - "end": 46, - "start": 43, + "end": 53, + "start": 50, "type": "RESPONSE_HANDLING" } ], diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_async.py index 6f73a05..ad915cc 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_CreateAgentPool_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_sync.py index 42c2cc1..4901df7 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_agent_pool_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_CreateAgentPool_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_async.py index 12f546f..603396f 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_CreateTransferJob_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_sync.py index dd6cacb..74eb2aa 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_create_transfer_job_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_CreateTransferJob_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_async.py index babfa3e..dfe0dc4 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_DeleteAgentPool_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_sync.py index 760f265..286c5de 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_agent_pool_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_DeleteAgentPool_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_async.py new file mode 100644 index 0000000..248ec94 --- /dev/null +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_async.py @@ -0,0 +1,51 @@ +# -*- coding: utf-8 -*- +# Copyright 2022 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for DeleteTransferJob +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-storage-transfer + + +# [START storagetransfer_v1_generated_StorageTransferService_DeleteTransferJob_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import storage_transfer_v1 + + +async def sample_delete_transfer_job(): + # Create a client + client = storage_transfer_v1.StorageTransferServiceAsyncClient() + + # Initialize request argument(s) + request = storage_transfer_v1.DeleteTransferJobRequest( + job_name="job_name_value", + project_id="project_id_value", + ) + + # Make the request + await client.delete_transfer_job(request=request) + + +# [END storagetransfer_v1_generated_StorageTransferService_DeleteTransferJob_async] diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_sync.py new file mode 100644 index 0000000..1113480 --- /dev/null +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_delete_transfer_job_sync.py @@ -0,0 +1,51 @@ +# -*- coding: utf-8 -*- +# Copyright 2022 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +# Generated code. DO NOT EDIT! +# +# Snippet for DeleteTransferJob +# NOTE: This snippet has been automatically generated for illustrative purposes only. +# It may require modifications to work in your environment. + +# To install the latest published package dependency, execute the following: +# python3 -m pip install google-cloud-storage-transfer + + +# [START storagetransfer_v1_generated_StorageTransferService_DeleteTransferJob_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html +from google.cloud import storage_transfer_v1 + + +def sample_delete_transfer_job(): + # Create a client + client = storage_transfer_v1.StorageTransferServiceClient() + + # Initialize request argument(s) + request = storage_transfer_v1.DeleteTransferJobRequest( + job_name="job_name_value", + project_id="project_id_value", + ) + + # Make the request + client.delete_transfer_job(request=request) + + +# [END storagetransfer_v1_generated_StorageTransferService_DeleteTransferJob_sync] diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_async.py index 8d36892..c9db758 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_GetAgentPool_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_sync.py index 6360736..7baa277 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_agent_pool_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_GetAgentPool_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_async.py index deac950..a08810e 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_GetGoogleServiceAccount_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_sync.py index 9a526ad..202e612 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_google_service_account_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_GetGoogleServiceAccount_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_async.py index bfed684..d93dde5 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_GetTransferJob_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_sync.py index a1fad23..fa7103f 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_get_transfer_job_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_GetTransferJob_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_async.py index 8ece425..c45db4f 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_ListAgentPools_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_sync.py index 24c55d6..6a71dc3 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_agent_pools_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_ListAgentPools_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_async.py index fd7ccd5..58ead55 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_ListTransferJobs_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_sync.py index e249196..1a97992 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_list_transfer_jobs_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_ListTransferJobs_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_async.py index cf3e78f..e54ff2e 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_PauseTransferOperation_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_sync.py index 0fc32be..27a6363 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_pause_transfer_operation_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_PauseTransferOperation_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_async.py index 957c186..97b52be 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_ResumeTransferOperation_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_sync.py index 43ed673..c560836 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_resume_transfer_operation_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_ResumeTransferOperation_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_async.py index 3f6cc13..d6cb766 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_RunTransferJob_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_sync.py index 26e6f5f..ec60a4b 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_run_transfer_job_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_RunTransferJob_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_async.py index b803ed6..20a492c 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_UpdateAgentPool_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_sync.py index c6ffb97..5fe7b44 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_agent_pool_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_UpdateAgentPool_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_async.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_async.py index eaf4397..5b7bd83 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_async.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_async.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_UpdateTransferJob_async] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_sync.py b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_sync.py index 9def81a..3d60567 100644 --- a/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_sync.py +++ b/samples/generated_samples/storagetransfer_v1_generated_storage_transfer_service_update_transfer_job_sync.py @@ -24,6 +24,13 @@ # [START storagetransfer_v1_generated_StorageTransferService_UpdateTransferJob_sync] +# This snippet has been automatically generated and should be regarded as a +# code template only. +# It will require modifications to work: +# - It may require correct/in-range values for request initialization. +# - It may require specifying regional endpoints when creating the service +# client as shown in: +# https://googleapis.dev/python/google-api-core/latest/client_options.html from google.cloud import storage_transfer_v1 diff --git a/scripts/fixup_storage_transfer_v1_keywords.py b/scripts/fixup_storage_transfer_v1_keywords.py index d20ff1c..929e06b 100644 --- a/scripts/fixup_storage_transfer_v1_keywords.py +++ b/scripts/fixup_storage_transfer_v1_keywords.py @@ -42,6 +42,7 @@ class storage_transferCallTransformer(cst.CSTTransformer): 'create_agent_pool': ('project_id', 'agent_pool', 'agent_pool_id', ), 'create_transfer_job': ('transfer_job', ), 'delete_agent_pool': ('name', ), + 'delete_transfer_job': ('job_name', 'project_id', ), 'get_agent_pool': ('name', ), 'get_google_service_account': ('project_id', ), 'get_transfer_job': ('job_name', 'project_id', ), diff --git a/setup.py b/setup.py index 11f5fd5..d6d7c18 100644 --- a/setup.py +++ b/setup.py @@ -22,7 +22,7 @@ name = "google-cloud-storage-transfer" description = "Storage Transfer API client library" url = "https://github.com/googleapis/python-storage-transfer" -version = "1.4.1" +version = "1.5.0" release_status = "Development Status :: 5 - Production/Stable" dependencies = [ "google-api-core[grpc] >= 1.32.0, <3.0.0dev,!=2.0.*,!=2.1.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*", diff --git a/tests/unit/gapic/storage_transfer_v1/test_storage_transfer_service.py b/tests/unit/gapic/storage_transfer_v1/test_storage_transfer_service.py index 0a460c3..7ad5858 100644 --- a/tests/unit/gapic/storage_transfer_v1/test_storage_transfer_service.py +++ b/tests/unit/gapic/storage_transfer_v1/test_storage_transfer_service.py @@ -18,8 +18,8 @@ # try/except added for compatibility with python < 3.8 try: from unittest import mock - from unittest.mock import AsyncMock -except ImportError: + from unittest.mock import AsyncMock # pragma: NO COVER +except ImportError: # pragma: NO COVER import mock import math @@ -2070,6 +2070,156 @@ async def test_run_transfer_job_field_headers_async(): ) in kw["metadata"] +@pytest.mark.parametrize( + "request_type", + [ + transfer.DeleteTransferJobRequest, + dict, + ], +) +def test_delete_transfer_job(request_type, transport: str = "grpc"): + client = StorageTransferServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_transfer_job), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = None + response = client.delete_transfer_job(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == transfer.DeleteTransferJobRequest() + + # Establish that the response is the type that we expect. + assert response is None + + +def test_delete_transfer_job_empty_call(): + # This test is a coverage failsafe to make sure that totally empty calls, + # i.e. request == None and no flattened fields passed, work. + client = StorageTransferServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + transport="grpc", + ) + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_transfer_job), "__call__" + ) as call: + client.delete_transfer_job() + call.assert_called() + _, args, _ = call.mock_calls[0] + assert args[0] == transfer.DeleteTransferJobRequest() + + +@pytest.mark.asyncio +async def test_delete_transfer_job_async( + transport: str = "grpc_asyncio", request_type=transfer.DeleteTransferJobRequest +): + client = StorageTransferServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + transport=transport, + ) + + # Everything is optional in proto3 as far as the runtime is concerned, + # and we are mocking out the actual API, so just send an empty request. + request = request_type() + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_transfer_job), "__call__" + ) as call: + # Designate an appropriate return value for the call. + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + response = await client.delete_transfer_job(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == transfer.DeleteTransferJobRequest() + + # Establish that the response is the type that we expect. + assert response is None + + +@pytest.mark.asyncio +async def test_delete_transfer_job_async_from_dict(): + await test_delete_transfer_job_async(request_type=dict) + + +def test_delete_transfer_job_field_headers(): + client = StorageTransferServiceClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = transfer.DeleteTransferJobRequest() + + request.job_name = "job_name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_transfer_job), "__call__" + ) as call: + call.return_value = None + client.delete_transfer_job(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) == 1 + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "job_name=job_name_value", + ) in kw["metadata"] + + +@pytest.mark.asyncio +async def test_delete_transfer_job_field_headers_async(): + client = StorageTransferServiceAsyncClient( + credentials=ga_credentials.AnonymousCredentials(), + ) + + # Any value that is part of the HTTP/1.1 URI should be sent as + # a field header. Set these to a non-empty value. + request = transfer.DeleteTransferJobRequest() + + request.job_name = "job_name_value" + + # Mock the actual call within the gRPC stub, and fake the request. + with mock.patch.object( + type(client.transport.delete_transfer_job), "__call__" + ) as call: + call.return_value = grpc_helpers_async.FakeUnaryUnaryCall(None) + await client.delete_transfer_job(request) + + # Establish that the underlying gRPC stub method was called. + assert len(call.mock_calls) + _, args, _ = call.mock_calls[0] + assert args[0] == request + + # Establish that the field header was sent. + _, _, kw = call.mock_calls[0] + assert ( + "x-goog-request-params", + "job_name=job_name_value", + ) in kw["metadata"] + + @pytest.mark.parametrize( "request_type", [ @@ -3647,6 +3797,7 @@ def test_storage_transfer_service_base_transport(): "pause_transfer_operation", "resume_transfer_operation", "run_transfer_job", + "delete_transfer_job", "create_agent_pool", "update_agent_pool", "get_agent_pool",
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies: