Share
Embed
【初学者向け】使ってみようIBM Cloud API/dojo-20230330-ibmcloudapi
※本資料は以下のイベントの投影資料です
https://ibm-developer.connpass.com/event/277609/
皆様が普段ご利用されている各種Webサービスには、多くの場合APIが提供されています。 IBM Cloudも、他の主要なクラウドプロバイダーと同様に、APIを提供しています。
APIを利用することで、複雑な操作を短時間で行うことができたり、繰り返し操作する負荷を軽減することができます。
本ウェビナーでは、APIの利用に慣れていない方を対象に、IBM Cloud APIを活用するための基本的な知識をお伝えします。
以下に関するご説明をを予定しています。
・APIとは
・IBM Cloud API Docsを利用したAPI仕様の確認方法
・IBM Cloud APIを使用したサンプルプログラムのご紹介
サンプルプログラムでは、IBM Cloud Console(GUI)で行う参照系の操作に対応するAPIをいくつかご紹介します。
是非、IBM Cloudをより有効に活用いただくためのスキルアップにご活用ください。
HirokiK
March 30, 2023
Transcript
49 slides
-
© 2023 IBM Corporation 2 ࣗݾհ ௺ ༟ل ͖ͨͮΊ ͻΖ͖
%BUB"*୲ $VTUPNFS4VDDFTT.BOBHFS 1VSQPTF ͓٬༷ͷઓΛࢧ͑ŊدΓఴ͏ύʔτφʔͱͳΔ ܦྺ ϓϩμΫτ։ൃϚωδϝϯτŊ͚ࣾใൃ৴ ࣗࣾϓϥοτϑΥʔϜαʔϏεاըఏҊ ΤΞϥΠϯܥγεςϜؒ௨৴։ൃŊอक $VTUPNFS4VDDFTT.BOBHFS"SDIJUFDU $FSUJGJFE4DSVN1SPEVDU0XOFS "EWPDBUF*#.$MPVEW )$%/FU ਓؒத৺ઃܭεϖγϟϦετ &NBJM IJSPLJLJUB[VNF!JCNDPN -JOLFE*OIUUQTMJOLFEJODPNJOIJSPLJLJUB[VNF -
© 2022 IBM Corporation 3 ໔ࣄ߲ ຊࢿྉʹؚ·ΕΔใՄೳͳݶΓਖ਼֬Λظ͓ͯ͠Γ·͕͢ɺ هࡌ͞Εͨ༰ʹؔͯ͠ɺຊΞΠɾϏʔɾΤϜגࣜձ͕ࣾ ԿΒอূ͢ΔͷͰ͋Γ·ͤΜɻ ैͬͯɺຊࢿྉͷใͷར༻༻ऀͷʹ͓͍ͯ
ҝ͞ΕΔͷͰ͋Γɺࢿྉͷ༰ʹΑͬͯड͚ͨ ԿͳΔඃʹؔͯ͠ҰͷิঈΛ͢ΔͷͰ͋Γ·ͤΜɻ <ըڐՄͷ͓ئ͍ %PKPͷ༷ࢠΛը͠ŊΞʔΧΠϒͱͯ͠ެ։͍ͤͯͩ͘͞͞Ň օ༷ͷ͓إŊ໊͓લөΒͳ͍Α͏ʹઃఆ͍ͯ͠·͢Ň -
© 2023 IBM Corporation 4 ରऀͱత • "1*ͱͲΜͳͷ͔͏·͘આ໌Ͱ͖ͳ͍ • "1*Λར༻ͨ͜͠ͱ͕ͳ͍
*#.$MPVE"1*ͷ۩ମྫΛࡐʹŊ༷ͷௐํŊར༻ͷํ͕͔ΔΑ͏ʹͳ ΔŇ ରऀ త -
© 2023 IBM Corporation 5 αϯϓϧϓϩάϥϜͷ͝આ໌ʹ͋ͨͬͯͷҙࣄ߲ • αϯϓϧίʔυ1ZUIPOͰ࡞͍ͯ͠·͢Ň ଞͷϓϩάϥϜݴޠͰಉ༷ͷ ػೳ͕࣮ՄೳͰ͢Ň
ॲཧ༰ͷઆ໌ߦ͍·͕͢Ŋ1ZUIPOͷ࣮ߦڥه๏ͷઆ໌ߦ͍·ͤΜ ͷͰ͝ঝ͓͖͍ͩ͘͞Ň • ϓϩάϥϜʹηΩϡϦςΟใͷهड़͕ඞཁͳͨΊŊμϛʔͷʹஔ͖ ͑ͯ͝આ໌͠·͢ŇͦͷͨΊŊίʔυΛ࣮ࡍʹ࣮ߦ͢Δͱ͜ΖΛ͓ݟͤ͢Δ͜ ͱ͕Ͱ͖·ͤΜŇ ίʔυͷ༰ͱŊೖग़ྗϑΝΠϧͷ༰Ͱ͝આ໌͠·͢Ň • ݸʑͷ"1*ͷϦΫΤετϨεϙϯεͷৄࡉŊऔಘͨ͠Λग़ྗ༻ʹՃ͢ Δॲཧͷઆ໌ׂѪ͓ͯ͠Γ·͢Ňαϯϓϧίʔυ(JU)VCͰެ։͍ͯ͠· ͢ͷͰŊΣϏφʔޙʹͥͻ֬͝ೝ͍ͩ͘͞Ň IUUQTHJUIVCDPN*#.%FWFMPQFS5PLZPEPKPJCNDMPVEBQJ ҙࣄ߲ -
© 2023 IBM Corporation 6 ΞδΣϯμ 8FC"1*ͷجຊ *#.$MPVE"1*%PDTΛར༻ͨ͠"1*༷ͷ֬ೝํ๏
*#.$MPVE"1*Λ༻ͨ͠αϯϓϧϓϩάϥϜ ·ͱΊ2" -
© 2023 IBM Corporation 8 "1*ͱ ɾ"QQMJDBUJPO1SPHSBNNJOH*OUFSGBDFͷུ ɾιϑτΣΞίϯϙʔωϯτಉ͕࢜ޓ͍ʹใΛΓͱΓ͢Δͷʹ ༻͢ΔΠϯλϑΣʔεͷ༷ 8JLJQFEJBʮΞϓϦέʔγϣϯϓϩάϥϛϯάΠϯλϑΣʔεʯIUUQTKBXJLJQFEJBPSHXJLJΞϓϦέʔγϣϯϓϩάϥϛϯάΠϯλϑΣʔε
ࢀরʣ ɾΠϯλϑΣʔεɿػೳΘ͔͍ͬͯΔ͚ΕͲͦͷதͷ࣮ࡍͷಈ࡞ৄ͘͠Θ ͔Βͳ͍ Βͳͯ͘Α͍ ػೳͷΧλϚϦΛŊ֎෦͔Βݺͼग़ͨ͢Ίͷ༷ͷ͜ͱ ਫو໌ʮষ 8FC"1*ͱԿ͔ʯ ʰ8FC"1*5IF(PPE1BSUTʱΦϥΠϦʔɾδϟύϯ Q -
© 2023 IBM Corporation 9 "1*ͱ ྉཧͷจʹྫ͑Δͱ จ จͷํͱఏڙ͞ΕΔαʔϏε͕Θ͔Ε ௐཧํ๏ΛΒͳͯ͘ྑ͍
Ξτϓοτ Φʔμʔελοϑ ͓٬༷ γΣϑ αʔϏεఏڙऀ͕͍ͳ͍ͱ αʔϏεఏڙऀ ར༻ऀ ࣗͰௐཧ͠ͳͯ͘ͳΒͳ͍ γΣϑͱಉ͡Α͏ʹඒຯ͘͠࡞Δʹௐཧํ๏Λ͍ͬͯͳ͚ΕͳΒͳ͍ ˠΞτϓοτΛखʹೖΕΔͨΊʹΔ͜ͱ͕૿͑Δ -
© 2023 IBM Corporation 10 "1*ͱ ɾ͞ΒʹŊ)551)5514ϓϩτίϧΛར༻ͯ͠ωοτϫʔΫӽ͠ʹݺͼग़͢ͷΛ 8FC "1*ͱݺͼ·͢Ň ຊͷઆ໌ର8FC"1*Ͱ͢Ň8FC"1*Ҏ֎ʹŊϓϩάϥϛϯάݴޠ"1*
ྫ+BWB"1* 1ZUIPO"1* Ŋσ ʔλϕʔε"1* ྫ0%#$ ͳͲ͕͋Γ·͢Ň ɾ ࠶ܝ ιϑτΣΞίϯϙʔωϯτಉ͕࢜ޓ͍ʹใΛΓͱΓ͢Δͷʹ ༻͢ΔΠϯλϑΣʔεͷ༷ ࣮ߦํ๏ͱ࣮ߦ͞ΕΔαʔϏε͕Θ͔Ε ෦ͷॲཧͷΈΒͳͯ͘ྑ͍ "1*ͷϝϦοτ "1*ར༻ऀ ϓϩάϥϜ "1*ఏڙऀ ϓϩάϥϜ "1* ෦ॲཧ ϦΫΤετ Ϩεϙϯε -
© 2023 IBM Corporation 11 8FC "1*Λར༻͢ΔϝϦοτɾσϝϦοτ <ϝϦοτ> ɾࣗαʔϏεͷརศੑͷ্ ɾίετͰػೳ͕ՃՄೳ
ɾηΩϡϦςΟͷ্ <σϝϦοτ> ɾ༷มߋ༗ྉԽŊোͱ͍ͬͨఏڙऀଆͷґଘͷՄೳੑ ΞϯυΤϯδχΞʮ 8FC"1*ͱʁΈ͍ํɺϝϦοτΛΘ͔Γ͘͢ղઆʂ ʯIUUQTBOEFOHJOFFSDPNBSUJDMFT:XT3"""$*"U8IFBEJOH ࢀরʣ -
© 2023 IBM Corporation 12 ࢀߟ ओͳγεςϜؒ࿈ܞํ๏ͱͷൺֱ ファイル連携 メッセージキュー API連携
図 メリット ・⼤容量で⾼速転送可能 ・⾮同期処理が可能 ・意図した順番を維持して処理される ・⾮同期処理が可能 ・リアルタイム連携が可能 ・同期処理が可能 デメリット ・ファイル⽣成するまで連携できない (ファイルの静⽌点) ・リアルタイムな連携は苦⼿ ・同期処理は苦⼿ ・⼤容量通信は苦⼿ ・リアルタイムな連携は苦⼿ ・同期処理は苦⼿ ・⼤容量通信は苦⼿ ・⾮同期処理は苦⼿ B キュー(待ち行列) 1 2 3 4 5 システム A システム B API 登録 参照 更新 システム A システム B (HTTP等) (HTTP等) リクエスト リクエスト レスポンス レスポンス システム A システム B (FTP等) ファイル (FTP等) ɾϦΞϧλΠϜ࿈ܞɿσʔλͷมߋૢ࡞Λଈ࣌ө͢Δ͜ͱ ɾಉظॲཧɿσʔλͷมߋૢ࡞ͷࡍʹŊҰఆ࣌ؒŊॲཧऴྃͳͲͷΠϕϯτΛͭॲཧํࣜ -
© 2023 IBM Corporation 13 ͳͥ"1*͕͞Ε͍ͯΔ͔ ʮ"1*Τίϊϛʔʯ 8FC"1*Λެ։͢Δ͜ͱͰ֎෦αʔϏεͱͷ࿈ܞΛ༻ҙʹͯ͠৽ͨͳՁ͕ੜ·ΕŊαʔϏεϏ δωε͕ൃల͍ͯ͘͜͠ͱ ਫو໌ʮ"1*Τίϊϛʔʯ
ʰ8FC"1*5IF(PPE1BSUTʱΦϥΠϦʔɾδϟύϯ Q ۙͳྫɿ(PPHMF.BQ اۀͷίʔϙϨʔταΠτϨετϥϯධՁαΠτʹਤ͕ຒΊࠐ·Ε͍ͯΔ 1SPHSBNNBCMF8FC ੈքతͳ"1*σΟϨΫτϦͷαΠτ ͷϑΝϯμʔͷ+PIO.VTTFSŊ"1*ͷ ެ։͞·͟·ͳαʔϏε͕૬ޓʹ࿈ܞͭͭ͠ܗ͢ΔαʔϏεͷΤίγεςϜͷதͰzணࡎzͷ ಇ͖Λ͢Δͱड़ͨͱ͍͍·͢Ň ਫو໌ʮ"1*Λެ։͢Δ͜ͱͰಘΒΕΔͷʯ ʰ8FC"1*5IF(PPE1BSUTʱΦϥΠϦʔɾδϟύϯ Q αʔϏεΛެ։͢ΔྗΛ࣋ͬͨ։ൃऀʹ"1*Λެ։͢Δ͜ͱͰŊ൴Β͕αʔϏεʹՃՁΛ༩͑ ͯ͘ΕŊίΞͱͳΔࣗͨͪͷαʔϏε͕ΑΓൃల͢ΔྗΛΒ͏͜ͱ͕Ͱ͖ΔŇ ਫو໌ʮ8FC"1*ͷॏཁੑʯ ʰ8FC"1*5IF(PPE1BSUTʱΦϥΠϦʔɾδϟύϯ Q -
© 2023 IBM Corporation 14 1045BQJVTFST)551 )PTUFYBNQMFDPN $POUFOU5ZQFBQQMJDBUJPOKTPO "VUIPSJ[BUJPO#FBSFSBCDEFGH \
OBNF+PIO%PF FNBJMKPIOEPF!FYBNQMFDPN QBTTXPSETFDSFU ^ ʲ)551جૅʳ)551ϦΫΤετͱ )551ϦΫΤετ"1*ΫϥΠΞϯτ͕8FCαʔόʹૹ৴͢Δใͷ͜ͱͰ͋ΓŊ )551ϝιου ࣍ϖʔδͰઆ໌ ɺϦΫΤετઌ63-ɺϔομʔɺϘσΟͳͲͷཁૉͰ ߏ͞Ε͍ͯ·͢ɻ 8FC"1*ͷΞΫηεɺ)551ϦΫΤετΛ༻ͯ͠ߦΘΕ·͢ɻ <)551ϦΫΤετߏͷαϯϓϧ> ϦΫΤετϥΠϯɿ)551ϝιουŊϦΫΤετઌ63-Ŋϓϩτίϧ ϔομɿ)551ϦΫΤετͷϝλσʔλ ϘσΟɿϦΫΤετͷσʔλ ྫ+40/ܗࣜ ޙड़ Ͱ͕͢Ŋ9.-ͳͲͦͷଞܗࣜͰ͋Δ߹ ͋Γ·͢Ň -
© 2023 IBM Corporation 15 ʲ)551جૅʳجຊͷ)551ϝιου ɾ)551ϓϩτίϧͰఆٛ͞Εͨɺ8FCαʔόʔʹରͯ͠ΫϥΠΞϯτ͕ཁٻΛߦ ͏ͨΊʹ༻͞ΕΔίϚϯυͷ͜ͱͰ͢ɻ ɾΑ͘ΘΕΔͷҎԼͷͭͰ͢Ň )&"%Ŋ015*0/4ͳͲଞʹ͋Γ·͢Ň
ޙͷαϯϓϧϓϩάϥϜͰ༻͢Δͷ(&5Ŋ1045Ͱ͢Ň HTTPメソッド 説明 使⽤例 GET サーバからの情報の取得 ブラウザからのWebページの読み込み POST サーバへのデータ送信 フォームの⼊⼒情報の送信 PUT サーバ上のデータの更新 既存データの更新 DELETE サーバ上のデータの削除 不要データの削除 -
© 2023 IBM Corporation 16 ʲσʔλܗࣜʳ+40/ ɾ8FC"1*ͷϦΫΤετϨεϙϯεͰΘΕΔ͜ͱ͕ଟ͍σʔλܗࣜͰ͢Ň ɾܰྔͰՄಡੑ͕ߴ͍͜ͱ͕ಛͰ͋ΓŊ8FC"1*ʹݶΒͣଟ͘ͷϓϩάϥϛϯά ݴޠͰ͘ར༻͞Ε͍ͯ·͢Ň ,%%*ʮʮ+40/ʯͱʁඇΤϯδχΞͰΑ͘Θ͔ΔղઆʯIUUQTDMPVEBQJLEEJXFCDPNNBHB[JOFKTPOKBWBTDSJQUPCKFDUOPUBUJPO
ࢀরʣ { "name": "John Smith", "address": { "street": "123 Main St", "city": "Anytown” }, "phone_numbers": [ { "type": "home", "number": "555-555-1234” }, { "type": "work", "number": "555-555-5678" } ] } ΦϒδΣΫτ lLFZzlWBMVFzͷू߹ ྻŇ͜ͷྫͰͭͷΦϒδΣΫτ͕ཁૉŇ -
© 2023 IBM Corporation 18 *#.$MPVEͱ *#.$MPVEΦʔϓϯςΫϊϩδʔΛجຊʹߏ͞Εͨ*#.ͷηΩϡΞͳϏδωε ͚ͷΫϥυͰ͢ɻ ʮΞϓϦέʔγϣϯʯɺʮ"*ʯɺʮσʔλʯΛࢧ͑ΔϓϥοτϑΥʔϜͱͯ͠ɺ 4BB4ɺ1BB4ɺ*BB4ͳͲ༷ʑͳαʔϏε͕ར༻Ͱ͖·͢ɻ
IUUQTDMPVEJCNDPN 50, 6, &6%& 644UI 64&BTU "64 %$T .;3T ";T 7.XBSF 9 *#.1PXFS -JOVY0OF ,VCFSOFUFT 0QFO4IJGU $MPVE/BUJWF #BDLVQ"SDIJWF $POUFOU.HU #BSF .FUBM 7JSUVBM .BDIJOFT ,VCFSOFUFT 'JMF 4UPSBHF #MPDL 4UPSBHF 0CKFDU 4UPSBHF 1SPEVDUT4FSWJDF %BUBc#MPDLDIBJOc*P5 4FDVSJUZc"OBMZUJDTc"* "QQMJDBUJPOT %BUB *OUFHSBUJPO "VUPNBUJPO 4FDVSJUZ .BOBHFNFOU *#. $MPVE *BB41BB4 IUUQTDMPVEJCNDPNDBUBMPH IUUQTJCNCJ[DMPVEDIFBUTIFFU 04" 503 4"0 -
© 2023 IBM Corporation 20 ͲͷΑ͏ͳ"1*͕͋Δͷ͔ "1*Λఏڙ͢Δ֤छαʔϏεŇ ݱ࣌ݸ ͦΕͧΕෳݸͷ"1*Λ࣋ͭŇ ࠓճ༻͢ΔͷʮϓϥοτϑΥʔ
ϜʯΧςΰϦʔŇ ΞΧϯτŊϦιʔεŊΞΫηεݖݶ ͷཧʹؔ͢Δ"1*Ň -
© 2023 IBM Corporation 21 υΩϡϝϯτͷ͍ํ Step 項⽬ 説明、例 1
やりたい操作を考える 例) アクセスグループのリストを取得したい。 2 APIドキュメントを探す IBM Cloud API Docsから「IAM Access Groups」を特定する。 (あるいは「ibm cloud access group list api」のように検索したほうが⾒つけやすい場合があり ます。) 3 エンドポイント(アクセ ス先URL)を特定する 個々のドキュメントの「Endpoint URLs」セクションに記載があります。 「IAM Access Groups」の場合は「https://iam.cloud.ibm.com」 4 リクエストを理解する APIに送信するデータの形式や必要な項⽬。 5 レスポンスを理解する APIが返すデータやエラーの詳細。 HTTPエラーコードなどエラーの詳細は「Error handling」セクションに記載があります。 6 APIを実⾏する curlコマンドやプログラムから実⾏ -
© 2023 IBM Corporation 22 ʲυΩϡϝϯτͷݟํʳϦΫΤετ $VTUPN)FBEFSϢʔβఆٛͷϔομ αϯϓϧίʔυ $VSM +BWB
/PEF 1ZUIPO (P 2VFSZ1BSBNFUFS63-ʹՃ͢Δύϥϝʔλ ˞ޙ΄Ͳิ͠·͢Ň )551ϝιουͱŊ&OEQPJOU 63-ʹՃ͢Δจࣈྻ &OEQPJOU63- lWHSPVQTz͕-JTUBDDFTTHSPVQT"1*ͷ63- ϔομ ϘσΟ ྫ BDDPVOU@JE͕ඞਢ 3FRVJSFE Ͱ͋Δ͜ͱ͕͔ΔŇ ͦͷଞ݁ՌߜΓࠐΈιʔτͳͲͷͨΊͷΦϓγϣϯŇ )551ϝιου 63- ϓϩτίϧ -
© 2023 IBM Corporation 23 ʲυΩϡϝϯτͷݟํʳϨεϙϯε ฦΔՄೳੑ͕͋Δ)551εςʔλείʔυ ྫ MJNJU PGGTFU
UPUBM@DPVOUඞͣฦΔ "MXBZT JODMVEFE ͜ͱ͕Θ͔ΔŇ Ϩεϙϯεσʔλͷαϯϓϧ ϨεϙϯεϘσΟ -
© 2023 IBM Corporation 24 ʲิʳΫΤϦύϥϝʔλͱϦΫΤετσʔλ ɾ)551ϦΫΤετʹ͓͍ͯŊΫΤϦύϥϝʔλͱϦΫΤετσʔλͱ͍͏छྨͷ ํ๏ͰϦΫΤετʹؚΊΔใΛࢦఆ͠·͢Ň ɾαϯϓϧίʔυͰར༻͢Δ"1*ͷଟ͘ΫΤϦύϥϝʔλͷࢦఆͷΈͰ͕͢ŊҰ ෦ϦΫΤετσʔλΛࢦఆ͢Δ"1*ར༻͍ͯ͠·͢Ň
ΞΫηετʔΫϯͷੜ 1045IUUQTJBNDMPVEJCNDPNWHSPVQT BDDPVOU@JEYYY)551 )PTUFYBNQMFDPN $POUFOU5ZQFBQQMJDBUJPOKTPO "VUIPSJ[BUJPO#FBSFSBCDEFGH \ HSBOU@UZQFVSOJCNQBSBNTPBVUIHSBOUUZQFBQJLFZ BQJLFZzYYYYYY ^ ϦΫΤετσʔλɿϦΫΤετϘσΟ෦ ϦιʔεͷՃŊߋ৽͢Δࡍͷ༰Λࢦఆ͢ΔŇ ΫΤϦύϥϝʔλɿϦΫΤετઌ63-෦ ʮ ʯҎ߱ʹΩʔͱͷϖΞΛࢦఆ͢ΔŇ ϦιʔεΛऔಘ͢Δࡍͷ༰Λࢦఆ͢ΔŇ ϖʔδωʔγϣϯݕࡧͳͲ 2JJUBʮ<3&45GVM"1*>ύεύϥϝʔλɺΫΤϦύϥϝʔλɺϦΫΤετϘσΟͷҧ͍ͱઃܭʯIUUQTRJJUBDPN4IPLPSFQJUFNTCBDCCDFGC ࢀর ʣ <)551ϦΫΤετߏͷαϯϓϧ> -
© 2023 IBM Corporation 26 ܦҢŊత ɾࢲͨͪ$VTUPNFS4VDDFTT.BOBHFS $4. ͓٬༷ʹͷՁΛ͍ͬͯͨͩͨ͘Ίͷ׆ಈͷ Ұ෦ͱͯ͠Ŋ*#.$MPVEΛͬͯ5FDI%PKPϋϯζΦϯŊ1P$ͳͲΛߦͳ͍ͬͯ·͢Ň
ɾࢲ෦ͷར༻ঢ়گͷཧΛ୲͍ͯ͠·͢ŇΠϯελϯεͷ࡞ऀΛಛఆɾه͢ΔͨΊŊҰׅ ͰΠϯελϯεͱ࡞ऀͷϦετΛग़ྗ͍ͨ͠ͱߟ͑·ͨ͠Ň 5FDI%PKP ϋϯζΦϯ 1P$ ͳͲ $4. $4. $4. *OTUBODF *OTUBODF *OTUBODF *#.$MPVE$POTPMFʹ ࢥͬͨΑ͏ͳ ϑΥʔϚοτͰͷ ΤΫεϙʔτػೳ͕ ͳ͔ͬͨ .F -
© 2023 IBM Corporation 27 ࡞ͷ֓ཁ ᶃ֤छ"1*ͷใΛΈ߹Θͤͨ Ϧιʔεৄࡉͱ࡞ऀใ ᶄϦιʔε͝ͱ༻ྔͷϑΝΠϧʹ ࡞ऀใΛՃ
Ϧιʔε͝ͱ༻ྔͷϑΝΠϧ *#.$MPVE$POTPMF͔Βμϯϩʔυ "1* 1ZUIPOϓϩάϥϜ ɾ*#. $MPVE "1*ΛΈ߹ΘͤͯŊͭͷϑΝΠϧΛग़ྗ͢ΔϓϩάϥϜΛ࡞Γ· ͨ͠Ň "1* "1* -
© 2023 IBM Corporation 28 ʲग़ྗϑΝΠϧαϯϓϧʳ ᶃ֤छ"1*ͷใΛΈ߹ΘͤͨϦιʔεৄࡉͱ࡞ऀใ SFTPVSDF@MJTU@ZZZZNNEE@IINNTTDTW # 列名
説明 取得元API 1 crn インスタンスID Resource Controller - Get a list of all resource instances 2 name リソース名 Resource Controller - Get a list of all resource instances 3 service_name1 csnから切り出したサービス名1 Resource Controller - Get a list of all resource instances 4 service_name2 csnから切り出したサービス名2 Resource Controller - Get a list of all resource instances 5 catalog_name リソース種別 Resource Controller - Get a list of all resource instances 6 created_at 作成時刻 Resource Controller - Get a list of all resource instances 7 created_by 作成者のユーザID、または作成元のサービスID Resource Controller - Get a list of all resource instances 8 email 作成者ユーザIDに対応するメールアドレス IAM Access Groups - List access groups IAM Access Groups - List access group members 9 workspace_created_by 拡張パラメータ内の作成者情報 Resource Controller - Get a list of all resource instances 10 tags タグ情報 Grobal Tagging - Get all tags 11 service_name サービス名 IAM Identity Services - List service IDs 12 service_description サービス説明 IAM Identity Services - List service IDs Ϣʔβ αʔϏε -
© 2023 IBM Corporation 29 ʲग़ྗϑΝΠϧαϯϓϧʳᶄϦιʔε͝ͱ༻ྔͷϑΝΠϧʹ࡞ऀใΛՃ VTBHF@MJTU@ZZZZNNEE@IINNTTDTW d d d
d DSO Πϯελϯε*% ɿ͜͜Λ,FZͱͯ͠Ŋ ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใΛՃ -
© 2023 IBM Corporation 30 αϯϓϧϓϩάϥϜͷߏ ᶃઃఆ߲ͷఆٛ ɾେ͖ͳߏҎԼͷͱ͓ΓͰ͢ŇॱΛͬͯ͝આ໌͠·͢Ň ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ
ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ ˞ΞΫηετʔΫϯɿ࠷େ࣌ؒΛظݶͱͨ͠Ұ࣌తͳࢿ֨ใŇӬٱతͳࢿ֨ใͰ͋Δ"1*,&:Λݩʹऔಘ͠ŊҎ߱ͷ֤ "1*࣮ߦ࣌ʹϔομʹઃఆ͢ΔŇ ˞ΞΫηεάϧʔϓɿάϧʔϓϝϯόʔʹҰׅͰݖݶϙϦγʔΛׂΓͯΔŊݖݶཧͷ୯Ґ -
© 2023 IBM Corporation 32 ʲ४උʳ *#. $MPVE $POTPMF͔ΒͷΞΧϯτ*%ͷऔಘ *#.$MPVEΞΧϯτͱ
ɾϢʔβΞΧϯτͰͳ͘ŊϦιʔεΛཧ͢Δ୯Ґͷ͜ͱɻ ɾΞΧϯτʹෳͷϦιʔεΛ࡞͢Δ͜ͱ͕Ͱ͖·͢ŇϢʔβʔෳͷΞΧϯτʹॴଐ͢Δ͜ͱ͕Ͱ͖·͢Ň ɾΞΧϯτ*%ΞΧϯτʹׂΓͯΒΕͨ*%Ͱ͢ŇηΩϡϦςΟ্ͷཧ༝͔Βɺ֎෦ʹ࿙Εͳ͍Α͏ʹཧͯͩ͘͠͞ ͍Ň *%ͷΛه -
© 2023 IBM Corporation 33 ʲ४උʳϦιʔε͝ͱ༻ྔͷϑΝΠϧͷμϯϩʔυ ༻ྔͷϑΝΠϧ͕࡞Ŋ μϯϩʔυ͞ΕΔ <αϯϓϧ μϛʔʹஔ͖͑
> d d μϯϩʔυ࣌Ͱ࡞ऀͷใΛؚ·ͳ͍Ň 1ZUIPOϓϩάϥϜͱಉ͡ϑΥϧμʹஔ͢ΔŇ -
© 2023 IBM Corporation 34 ᶃઃఆ߲ͷఆٛ ४උͰऔಘͨ͠Ͱ্ॻ͖͍ͯͩ͘͠͞ ᶃઃఆ߲ͷఆٛ ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ
ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ ˞αϯϓϧίʔυͰμϛʔͷʹॻ͖͍͑ͯ·͢Ň -
© 2023 IBM Corporation 35 ᶄΞΫηετʔΫϯͷੜ *". *EFOUJUZ4FSWJDFTr "VUIFOUJDBUJPO"1*ͰΞΫηε τʔΫϯΛऔಘ
ϦΫΤετσʔλʹ"1*,&:Ληοτ Ҏ߱ͷ"1*༻ͷϔομʹΞΫηετʔΫϯΛηοτ ᶃઃఆ߲ͷఆٛ ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ ΞΫηε τʔΫϯ "1* -
© 2023 IBM Corporation 36 ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ֤ΞΫηεάϧʔϓʹ͍ͭͯŊ *"."DDFTT (SPVQTr -JTUBDDFTTHSPVQTNFNCFST"1*Ͱ
ϝϯόʔϦετΛऔಘ ΞΫηεάϧʔϓɿάϧʔϓϝϯόʔʹҰׅͰݖݶϙϦγʔΛ ׂΓͯΔŊݖݶཧͷ୯Ґ *"."DDFTT(SPVQTr -JTUBDDFTTHSPVQT"1*ͰΞΫηεά ϧʔϓͷϦετΛऔಘ Ϣʔβ*%Λ,FZʹŊରԠ͢ΔϝʔϧΞυϨεΛอ࣋ ᶃઃఆ߲ͷఆٛ ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ ϝϯόʔ Ϧετ "1* "1* -
© 2023 IBM Corporation 37 ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ճͷϨεϙϯεʹฦͤΔͷ͕݅·ͰŇ OFYUʹ֨ೲ͞Εͨ63-͔Β࣍ͷ݅Λऔಘ αʔϏε*%Λ,FZʹରԠ͢ΔαʔϏε໊Ŋઆ໌Λอ࣋ ᶃઃఆ߲ͷఆٛ
ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ αʔϏε Ϧετ "1* *".*EFOUJUZ4FSWJDFTr -JTUTFSWJDF*%T"1*Ͱαʔ Ϗε*%ͷϦετΛऔಘ -
© 2023 IBM Corporation 38 ᶇϦιʔεҰཡΛऔಘ͠Ŋ ᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ 3FTPVSDF$POUSPMMFS
(FUBMJTUPGBMMSFTPVSDFJOTUBODFT "1*͔ΒϦιʔε ҰཡΛऔಘ͠ŊᶅᶆͰऔಘͨ͠ใΛ݁߹ ᶃઃఆ߲ͷఆٛ ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ "1* ϝϯόʔ Ϧετ αʔϏε Ϧετ -
© 2023 IBM Corporation 39 ᶇϦιʔεҰཡΛऔಘ͠Ŋ ᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ DSO
Πϯελϯε*% ʹରԠ͢ΔλάใΛ (SPCBM 5BHHJOH (FUBMMUBHT"1*͔Βऔಘ ϑΝΠϧग़ྗ ճͷϨεϙϯεʹฦͤΔͷ͕݅·ͰŇ OFYU@VSMʹ֨ೲ͞Εͨ63-͔Β࣍ͷ݅Λऔಘ ᶃઃఆ߲ͷఆٛ ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ ϑΝΠϧ ᶃ "1* -
© 2023 IBM Corporation 40 ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%Ŋ ϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ᶇͰ࡞ͨ͠ใΛ࠶ར༻
ಡΈࠐΜͩϑΝΠϧʹྻΛՃ ᶃઃఆ߲ͷఆٛ ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ -
© 2023 IBM Corporation 41 ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%Ŋ ϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ϑΝΠϧग़ྗ
ᶃઃఆ߲ͷఆٛ ᶄΞΫηετʔΫϯͷੜ ᶅ֤ΞΫηεάϧʔϓͷϝϯόʔϦετΛऔಘ ᶆ֤αʔϏε*%ͷαʔϏε໊ͱઆ໌Λऔಘ ᶇϦιʔεҰཡΛऔಘ͠ŊᶅᶆͷใΛ݁߹ͯ͠ϑΝΠϧग़ྗ ᶈಡΈࠐΈରϑΝΠϧʹ࡞ऀ*%ŊϝʔϧΞυϨεŊλάใͷྻΛ༩ͯ͠ग़ྗ ४උ खಈ ɿ *#.$MPVE$POTPMF͔Βͷઃఆͷऔಘ ΞΫηε τʔΫϯ ϝϯόʔ Ϧετ αʔϏε Ϧετ ϑΝΠϧ ᶃ ϑΝΠϧ ᶄ ϑΝΠϧᶃग़ྗ༻ใ࠶ར༻ ϑΝΠϧ ᶄ ೖྗ ϑΝΠϧ ϑΝΠϧ ᶃ༻ใ -
© 2023 IBM Corporation 43 ·ͱΊ *#.$MPVE"1*ͷ۩ମྫΛࡐʹŊ༷ͷௐํŊར༻ͷํ͕͔ΔΑ͏ʹͳ ΔŇ త •
"1*ͱιϑτΣΞίϯϙʔωϯτಉ͕࢜ޓ͍ʹใΛΓͱΓ͢Δͷʹ ༻͢ΔΠϯλϑΣʔεͷ༷Ͱ͋ΔŇ • 8FC "1*ʹαʔϏεಉ࢜Λܨ͛ŊαʔϏεϏδωε͕ൃలͤ͞Δྗ͕͋ ΔŇ "1*Τίϊϛʔ • *#.$MPVE "1* %PDT͔ΒతʹԠͨ͡"1*υΩϡϝϯτΛ୳͢͜ͱ͕Ͱ͖ΔŇ • αϯϓϧϓϩάϥϜΛ௨ͯ͡Ŋ"1*ͷར༻ํ๏ͷ۩ମྫΛֶΜͩŇ ৼΓฦΓ -
© 2023 IBM Corporation 44 *#.$MPVEΛ"1*Ͱͬͱ༗ޮ׆༻͠Α͏ ࠓճϦιʔεؔ࿈ͷࢀরͷΈͷ͝հͰ͕ͨ͠Ŋ *#.$MPVE"1*ͰͰ͖Δ͜ͱͬͱͨ͘͞Μ͋Γ·͢Ň <ྫ> ɾϦιʔεͷ࡞Ŋཧ
ɾ*#.$MPVEͷαʔϏεΛ"1*Ͱར༻͢Δ ࣗવݴޠॲཧŊػցֶशŊԻɾςΩετมŊͳͲ ࠓͷࣝΛ͕͔Γʹ*#. $MPVEͷັྗతͳ֤छαʔϏεΛ͝׆༻͍ͩ͘͞Ň -
© 2023 IBM Corporation 45 ͊࢝͞ΊΑ͏ ҎԼͷखॱΛࢀߟʹڥΛ४උ͍ͨͩ͘͜ͱͰɺαϯϓϧίʔυΛࣗ͝ͷϩʔΧ ϧڥͰ࣮ߦ͍͚ͨͩ·͢ɻ ࢿྉ •
*#.$MPVEΞΧϯτ *#.JE ͷ࡞ IUUQTDMPVEJCNDPNEPDTBDDPVOU UPQJDBDDPVOUBDDPVOUHFUUJOHTUBSUFE • *#.$MPVE"1*%PDT IUUQTDMPVEJCNDPNEPDT UBCBQJEPDT • αϯϓϧϓϩάϥϜ(JU)VC IUUQTHJUIVCDPN*#.%FWFMPQFS5PLZPEPKPJCNDMPVEBQJ ͦͷଞࢀߟࢿྉ 2JJUB • *#.$MPVEͷϦιʔεɾϦετʹ"1*Λͬͯ࡞ऀใΛՃ͢Δ ຊͷ༰ IUUQTRJJUBDPN,5;.JUFNTDGEBGGEB • DVSMίϚϯυʹΑΔҰཡͷऔಘ IUUQTRJJUBDPNPOPEBJUFNTECECGGCDGMJTUVTFSTͰϢʔβʔҰཡΛऔಘ͢Δ -
© 2023 IBM Corporation 47 ʲՃࢿྉʳ͍͍࣭ͨͩͨ͝ͷճ 2ճͷϨεϙϯεͰԿ݅ฦͤΔ͔ͲͷΑ͏ʹ֬ೝ͢ΔͷͳͷͰ͠ΐ͏͔ "
"1*༷ॻʹهࡌ͞Ε·͢Ň ྫ͑ŊαϯϓϧϓϩάϥϜͷύʔτᶆͰ༻͍ͯ͠Δ*".*EFOUJUZ4FSWJDFTr -JTUTFSWJDF*%T"1* ͷ߹Ŋ3FTQPOTF#PEZηΫγϣϯͷMJNJUͱ͍͏ύϥϝʔλͷઆ໌෦Ͱهࡌ͞Ε͍ͯ·͢Ň͜ͷ "1*ͷ߹σϑΥϧτͰ݅Ŋ݅ͷؒͰͷࢦఆ͕ՄೳͰ͢Ň IUUQTDMPVEJCNDPNBQJEPDTJBNJEFOUJUZUPLFOBQJMJTUTFSWJDFJETSFTQPOTF -
© 2023 IBM Corporation 48 ʲՃࢿྉʳ͍͍࣭ͨͩͨ͝ͷճ 2"1*ΩʔͷऔΓѻ͍ʹ͍࣭ͭͯͰ͢ɻ#BDLFOEGPS'SPOUFOEʢ#''ʣͷΑ͏ʹɺΫϥΠΞϯτʹ "1*ΩʔΛؚ·ͤͳ͍αʔϏεఏڙ͞Ε͍ͯ·͔͢ʁ͞Ε͍ͯͳ͍߹ɺࠓޙߨԋ͕ߦΘΕΔՄೳ
ੑʹ͍ͭͯڭ͑ͯͩ͘͞Δͱ͋Γ͕͍ͨͰ͢ɻ " *#."1* $POOFDUʹΑͬͯόοΫΤϯυ"1*ͷೝূใΛू͢Δ͜ͱ͕Ͱ͖·͢Ň "1* $POOFDUʹ͍ͭͯۙͷߨԋ༧ఆ͍͟͝·ͤΜ͕ŊհϖʔδΛ͝Ҋ͍ͨ͠·͢Ň IUUQTXXXJCNDPNKQKBQSPEVDUTBQJDPOOFDU "1*$POOFDU #'' $MJFOU ֎෦"1* ֎෦"1* ֎෦"1* ֎෦"1* ֎෦"1* ෦"1* $MJFOU"1*$POOFDUʹର͢Δ ೝূใͷΈอ࣋͢ΕΑ͍ ֤छόοΫΤϯυ"1*ʹର͢ΔೝূใΛ "1*$POOFDUʹू͢Δ͜ͱ͕Ͱ͖Δ ֤छόοΫΤϯυ"1*